documentation/manual/ru/module_specs/Zend_Mime_Message.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect1 id="zend.mime.message">
   4     <title>Zend_Mime_Message</title>
   5
   6     <sect2 id="zend.mime.message.introduction">
   7         <title>Введение</title>
   8         <para>
   9             <classname>Zend_Mime_Message</classname> представляет сообщения,
  10             составленные в соответствии со спецификациями
  11             <acronym>MIME</acronym>, такие сообщения могут содержать одну или
  12             более отдельных частей, представляемых как объекты класса
  13             <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>).
  14             С помощью <classname>Zend_Mime_Message</classname> из объектов
  15             <classname>Zend_Mime_Part</classname> могут быть сгенерированы
  16             сообщения MIME multipart. Также с помощью этого класса
  17             производится прозрачное управление кодированием и разделителями.
  18             Объекты <classname>Zend_Mime_Message</classname> могут быть
  19             восстановлены из данных строк (экспериментальная возможность).
  20             Используется
  21             <link linkend="zend.mail"><classname>Zend_Mail</classname></link>-ом.
  22         </para>
  23     </sect2>
  24
  25     <sect2 id="zend.mime.message.instantiation">
  26         <title>Инстанцирование</title>
  27         <para>
  28             Нет явного конструктора для <classname>Zend_Mime_Message</classname>.
  29         </para>
  30     </sect2>
  31
  32     <sect2 id="zend.mime.message.addparts">
  33         <title>Добавление частей MIME</title>
  34
  35         <para>
  36             Объекты <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>
  37             могут быть добавлены в конкретный объект
  38             <classname>Zend_Mime_Message</classname> путем вызова
  39             <code>-&gt;addPart($part)</code>.
  40         </para>
  41
  42         <para>
  43             Массив со всеми объектами частей
  44             <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>
  45             в <classname>Zend_Mime_Message</classname> возвращается методом
  46             <code>-&gt;getParts()</code>. Через этот массив можно вносить
  47             изменения в объекты частей, поскольку они хранятся в
  48             виде ссылок. Если в массив были добавлены новые части или
  49             последовательность изменилась, то массив нужно заново
  50             передать объекту
  51             <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>
  52             через вызов метода <code>-&gt;setParts($partsArray)</code>.
  53         </para>
  54
  55         <para>
  56             Функция <code>-&gt;isMultiPart()</code> вернет
  57             <constant>TRUE</constant>, если была зарегистрирована более чем
  58             одна часть в объекте <classname>Zend_Mime_Message</classname>
  59             и, следовательно, объект должен сгенерировать сообщение MIME multipart.
  60         </para>
  61     </sect2>
  62
  63     <sect2 id="zend.mime.message.bondary">
  64         <title>Управление разделителями</title>
  65
  66         <para>
  67             <classname>Zend_Mime_Message</classname> обычно создает и использует свой
  68             объект <classname>Zend_Mime</classname> для генерации разделителей.
  69             Если нужно самостоятельно установить разделители или изменить поведение
  70             объекта <classname>Zend_Mime</classname>, используемого <classname>Zend_Mime_Message</classname>,
  71             то можно самостоятельно создать экземпляр <classname>Zend_Mime</classname>
  72             и зарегистрировать его в <classname>Zend_Mime_Message</classname>
  73             (но обычно вам не нужно делать это). Метод <code>-&gt;setMime(Zend_Mime
  74             $mime)</code> устанавливает специальный экземпляр <code>Zend_Mime</code>,
  75             который будет использоваться данным объектом <classname>Zend_Mime_Message</classname>.
  76         </para>
  77
  78         <para>
  79             <code>-&gt;getMime()</code> возвращает экземпляр класса <classname>Zend_Mime</classname>,
  80             который будет использоваться для формирования сообщения при вызове метода
  81             <methodname>generateMessage()</methodname>.
  82         </para>
  83
  84         <para>
  85             <code>-&gt;generateMessage()</code> формирует содержимое
  86             <classname>Zend_Mime_Message</classname> в строке.
  87         </para>
  88     </sect2>
  89
  90     <sect2 id="zend.mime.message.parse">
  91         <title>Создание объекта Zend_Mime_Message из строки (экспериментальная возможность)</title>
  92
  93         <para>
  94             Если имеется сообщение MIME в виде строки, то оно может
  95             использоваться для получения объекта
  96             <classname>Zend_Mime_Message</classname>.
  97             <classname>Zend_Mime_Message</classname> имеет фабричный метод,
  98             который принимает строку и возвращает объект
  99             <classname>Zend_Mime_Message</classname>.
 100         </para>
 101
 102         <para>
 103             <methodname>Zend_Mime_Message::createFromMessage($str, $boundary)</methodname>
 104             декодирует переданную строку и возвращает объект
 105             <classname>Zend_Mime_Message</classname>,
 106             который затем может быть исследован с помощью <code>-&gt;getParts()</code>.
 107         </para>
 108     </sect2>
 109 </sect1>
 110 <!--
 111 vim:se ts=4 sw=4 et:
 112 -->