23.2. Zend_Mime_Message

23.2.1. Введение

Zend_Mime_Message представляет сообщения, составленные в соответствии со спецификациями MIME, которые могут содержать одну или более отдельных частей (представленные как объекты класса Zend_Mime_Part). С помощью Zend_Mime_Message из объектов Zend_Mime_Part могут быть сгенерированы сообщения MIME с типом multipart. Посредством этого класса управление кодированием и разделителями производится явным образом. Объекты Zend_Mime_Message могут быть восстановлены из данных строк (экспериментальная возможность). Используется Zend_Mail-ом.

23.2.2. Инстанцирование

Нет явного конструктора для Zend_Mime_Message.

23.2.3. Добавление частей MIME

Объекты 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.

23.2.4. Управление разделителями

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 в строке.

23.2.5. Разбор строки для создания объекта Zend_Mime_Message (экспериментальная возможность)

Данное в виде строки сообщение MIME может использоваться для восстановления объекта Zend_Mime_Message из него. Zend_Mime_Message имеет статический factory метод для разбора этой стоки и возвращения объекта Zend_Mime_Message.

Zend_Mime_Message::createFromMessage($str, $boundary) раскодировывает данную строку и возвращает объект Zend_Mime_Message, который затем может быть исследован с помощью ->getParts().