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

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

    <sect2 id="zend.mime.part.introduction">
    <title>Введение</title>

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

    <sect2 id="zend.mime.part.instantiation">
    <title>Инстанцирование</title>

    <para>
        Экземпляр класса <classname>Zend_Mime_Part</classname> создается с
        передачей строки, которая представляет собой содержимое новой части
        сообщения. По умолчанию используются тип OCTET-STREAM и кодировка 8Bit.
        После инстанцирования <classname>Zend_Mime_Part</classname> метаданные
        могут быть установлены путем прямого доступа к атрибутам:
    </para>

    <programlisting language="php"><![CDATA[
public $type = Zend_Mime::TYPE_OCTETSTREAM;
public $encoding = Zend_Mime::ENCODING_8BIT;
public $id;
public $disposition;
public $filename;
public $description;
public $charset;
public $boundary;
public $location;
public $language;
]]></programlisting>
    </sect2>

    <sect2 id="zend.mime.part.methods">
        <title>Методы для рендеринга строк из объекта части сообщения</title>

        <para>
            <methodname>getContent()</methodname> возвращает содержимое части
            сообщения, закодированное с применением кодировки, указанной в
            атрибуте $encoding. Корректными значениями являются
            ZMime::ENCODING_*. Преобразования по таблице символов не
            производятся.
        </para>

        <para>
            <methodname>getHeaders()</methodname> возвращает MIME-заголовки для
            части сообщения, они генерируются с учетом значений, установленных
            в открытых свойствах. Необходимо правильно установить свойства
            объекта до того, как будет вызван метод.

            <itemizedlist>
                <listitem>
                    <para>
                        <varname>$charset</varname>
                        должен соответствовать используемому в содержимом набору
                        символов, если это содержимое имеет текстовый тип (простой
                        текст или HTML).
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <varname>$id</varname>
                        устанавливается в качестве идентификатора
                        включенных изображений в сообщении HTML.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <varname>$filename</varname>
                        содержит имя, которое должно присваиваться файлу после
                        загрузки.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <varname>$disposition</varname>
                        определяет, должен ли файл обрабатываться как вложение
                        или использоваться внутри сообщения.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <varname>$description</varname>
                        используется только для информационных целей.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <varname>$boundary</varname>
                        используется как граница MIME.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <varname>$location</varname>
                        содержит <acronym>URI</acronym> ресурса.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <varname>$language</varname>
                        определяет язык содержимого.
                    </para>
                </listitem>
            </itemizedlist>
        </para>
    </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->