imap_fetchstructure
imap_fetchstructure
(PHP 3, PHP 4)
imap_fetchstructure - читает структуру определённого сообщения.
Описание
object imap_fetchstructure (int imap_stream, int msg_number [, int flags])
Эта функция извлекает всю структурную информацию данного сообщения. Необязательный параметр flags имеет только одну опцию, FT_UID, которая говорит функции - рассматривать аргумент msg_number как UID. Возвращаемый объект содержит оболочку, внутренние данные, размер, флаги и структуру тела вместе с похожим объектом для каждого mime-присоединения. Структура возвращаемых объектов такова:
Таблица 1. Возвращаемые объекты imap_fetchstructure()
| type | первичный тип тела/body |
| encoding | кодировка трансфера тела |
| ifsubtype | TRUE, если имеется строка subtype |
| subtype | MIME-подтип |
| ifdescription | TRUE, если если имеется строка description |
| description | строка описания содержимого |
| ifid | TRUE, если имеется строка id |
| id | строка идентификации |
| lines | количество строк |
| bytes | количество байтов |
| ifdisposition | TRUE, если имеется строка disposition |
| disposition | строка расположения |
| ifdparameters | TRUE, если существует массив dparameters |
| dparameters | массив объектов, где каждый объект имеет свойства "attribute" и "value", соответствующие параметрам Content-disposition MIME-header'а |
| ifparameters | TRUE, если массив parameters существует |
| parameters | массив объектов, где каждый объект имеет свойства "attribute" и "value" |
| parts | массив объектов, идентичный по структуре объекту верхнего уровня/top-level, каждый из которых соответствует MIME-части body. |
Таблица 2. Первичный тип тела
| 0 | text |
| 1 | multipart |
| 2 | message |
| 3 | application |
| 4 | audio |
| 5 | image |
| 6 | video |
| 7 | other |
Таблица 3. Кодировки трансфера
| 0 | 7BIT |
| 1 | 8BIT |
| 2 | BINARY |
| 3 | BASE64 |
| 4 | QUOTED-PRINTABLE |
| 5 | OTHER |
См. также imap_fetchbody().