Zend_Mime_Message
представляет сообщения, составленные в
соответствии со спецификациями MIME, которые могут содержать одну или более
отдельных частей (представленные как объекты класса
Zend_Mime_Part
).
С помощью Zend_Mime_Message
из объектов Zend_Mime_Part
могут быть сгенерированы сообщения MIME с типом multipart. Посредством этого класса
управление кодированием и разделителями производится явным образом.
Объекты Zend_Mime_Message
могут быть восстановлены из данных
строк (экспериментальная возможность). Используется
Zend_Mail
-ом.
Объекты Zend_Mime_Part
могут быть добавлены в данный объект Zend_Mime_Message
посредством вызова ->addPart($part)
.
Массив со всеми объектами Zend_Mime_Part
в Zend_Mime_Message
возвращается методом ->getParts()
.
Объекты Zend_Mime_Part
могут быть изменяться, поскольку
хранятся в массиве в виде ссылок. Если в массив были добавлены части или
последовательность изменилась, массив нужно вернуть объекту
Zend_Mime_Part
посредством вызова метода ->setParts($partsArray)
.
Функция ->isMultiPart()
вернет true
, если
была зарегистрирована более чем одна часть в объекте Zend_Mime_Message
и, следовательно, объект должен сгенерировать сообщение MIME типа multipart.
Zend_Mime_Message
обычно создает и использует свой
объект Zend_Mime
для генерации разделителей.
Если нужно самостоятельно установить разделители или изменить поведение
объекта Zend_Mime
, используемого Zend_Mime_Message
,
то можно самостоятельно создать экземпляр Zend_Mime
и зарегистрировать его в Zend_Mime_Message
(но обычно вам не нужно делать это). Метод ->setMime(Zend_Mime
$mime)
устанавливает специальный экземпляр Zend_Mime
,
который будет использоваться данным объектом Zend_Mime_Message
.
->getMime()
возвращает экземпляр класса Zend_Mime
,
который будет использоваться для формирования сообщения при вызове метода
generateMessage()
.
->generateMessage()
формирует содержимое
Zend_Mime_Message
в строке.
Данное в виде строки сообщение MIME может использоваться для
восстановления объекта Zend_Mime_Message
из него.
Zend_Mime_Message
имеет статический factory метод для
разбора этой стоки и возвращения объекта Zend_Mime_Message
.
Zend_Mime_Message::createFromMessage($str, $boundary)
раскодировывает данную строку и возвращает объект Zend_Mime_Message
,
который затем может быть исследован с помощью ->getParts()
.