19.2. Zend_Mime_Message
Пред. | Глава 19. Zend_Mime | След.

## 19.2. Zend_Mime_Message

### 19.2.1. Введение

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

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

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

### 19.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.

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

### 19.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()`.

Пред. | Уровень выше | След.
Глава 19. Zend_Mime | Начало | 19.3. Zend_Mime_Part