repo_zf1/documentation/manual/ru/module_specs/Zend_Mime_Message.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<sect1 id="zend.mime.message">
    <title>Zend_Mime_Message</title>

    <sect2 id="zend.mime.message.introduction">
        <title>Введение</title>
        <para>
            <classname>Zend_Mime_Message</classname> представляет сообщения,
            составленные в соответствии со спецификациями
            <acronym>MIME</acronym>, такие сообщения могут содержать одну или
            более отдельных частей, представляемых как объекты класса
            <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>).
            С помощью <classname>Zend_Mime_Message</classname> из объектов
            <classname>Zend_Mime_Part</classname> могут быть сгенерированы
            сообщения MIME multipart. Также с помощью этого класса
            производится прозрачное управление кодированием и разделителями.
            Объекты <classname>Zend_Mime_Message</classname> могут быть
            восстановлены из данных строк (экспериментальная возможность).
            Используется
            <link linkend="zend.mail"><classname>Zend_Mail</classname></link>-ом.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.instantiation">
        <title>Инстанцирование</title>
        <para>
            Нет явного конструктора для <classname>Zend_Mime_Message</classname>.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.addparts">
        <title>Добавление частей MIME</title>

        <para>
            Объекты <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>
            могут быть добавлены в конкретный объект
            <classname>Zend_Mime_Message</classname> путем вызова
            <code>-&gt;addPart($part)</code>.
        </para>

        <para>
            Массив со всеми объектами частей
            <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>
            в <classname>Zend_Mime_Message</classname> возвращается методом
            <code>-&gt;getParts()</code>. Через этот массив можно вносить
            изменения в объекты частей, поскольку они хранятся в
            виде ссылок. Если в массив были добавлены новые части или
            последовательность изменилась, то массив нужно заново
            передать объекту
            <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>
            через вызов метода <code>-&gt;setParts($partsArray)</code>.
        </para>

        <para>
            Функция <code>-&gt;isMultiPart()</code> вернет
            <constant>TRUE</constant>, если была зарегистрирована более чем
            одна часть в объекте <classname>Zend_Mime_Message</classname>
            и, следовательно, объект должен сгенерировать сообщение MIME multipart.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.bondary">
        <title>Управление разделителями</title>

        <para>
            <classname>Zend_Mime_Message</classname> обычно создает и использует свой
            объект <classname>Zend_Mime</classname> для генерации разделителей.
            Если нужно самостоятельно установить разделители или изменить поведение
            объекта <classname>Zend_Mime</classname>, используемого <classname>Zend_Mime_Message</classname>,
            то можно самостоятельно создать экземпляр <classname>Zend_Mime</classname>
            и зарегистрировать его в <classname>Zend_Mime_Message</classname>
            (но обычно вам не нужно делать это). Метод <code>-&gt;setMime(Zend_Mime
            $mime)</code> устанавливает специальный экземпляр <code>Zend_Mime</code>,
            который будет использоваться данным объектом <classname>Zend_Mime_Message</classname>.
        </para>

        <para>
            <code>-&gt;getMime()</code> возвращает экземпляр класса <classname>Zend_Mime</classname>,
            который будет использоваться для формирования сообщения при вызове метода
            <methodname>generateMessage()</methodname>.
        </para>

        <para>
            <code>-&gt;generateMessage()</code> формирует содержимое
            <classname>Zend_Mime_Message</classname> в строке.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.parse">
        <title>Создание объекта Zend_Mime_Message из строки (экспериментальная возможность)</title>

        <para>
            Если имеется сообщение MIME в виде строки, то оно может
            использоваться для получения объекта
            <classname>Zend_Mime_Message</classname>.
            <classname>Zend_Mime_Message</classname> имеет фабричный метод,
            который принимает строку и возвращает объект
            <classname>Zend_Mime_Message</classname>.
        </para>

        <para>
            <methodname>Zend_Mime_Message::createFromMessage($str, $boundary)</methodname>
            декодирует переданную строку и возвращает объект
            <classname>Zend_Mime_Message</classname>,
            который затем может быть исследован с помощью <code>-&gt;getParts()</code>.
        </para>
    </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->