imap_fetchstructure

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_fetchstructureЧитает структуру указанного сообщения

Описание

imap_fetchstructure(IMAP\Connection$imap, int$message_num, int$flags = 0): stdClass|false

Извлекает информацию о структуре указанного сообщения.

Список параметров

imap

Экземпляр класса IMAP\Connection.

message_num

Номер сообщения

flags

Если задано как FT_UID, то в message_num должны быть UID сообщений, а не их номера.

Возвращаемые значения

Возвращает объект со свойствами, перечисленными в таблице ниже или false, если возникла ошибка.

Объект, возвращаемый imap_fetchstructure()
typeПервичный тип тела
encodingКодировка тела
ifsubtypetrue, если есть строка подтипа
subtypeMIME-подтип
ifdescriptiontrue, если есть строка описания
descriptionКонтент строки описания
ifidtrue, если есть строка идентификатор
idСтрока идентификатор
linesКоличество строк
bytesКоличество байт
ifdispositiontrue, если есть строка расположения
dispositionСтрока расположения
ifdparameterstrue, если есть массив dparameters
dparametersМассив объектов, каждый из которых имеет свойства "attribute" и "value", соответствующие параметрам Content-disposition заголовка MIME.
ifparameterstrue, если есть массив параметров
parametersМассив объектов, каждый из которых имеет свойства "attribute" и "value".
partsМассив объектов идентичных по структуре с верхнеуровневым объектом, каждый из которых соответствует MIME части тела.

Первичный тип тела (значения могут отличаться в зависимости от используемой библиотеки, так что рекомендуется использовать константы)
ЗначениеТипКонстанта
0textTYPETEXT
1multipartTYPEMULTIPART
2messageTYPEMESSAGE
3applicationTYPEAPPLICATION
4audioTYPEAUDIO
5imageTYPEIMAGE
6videoTYPEVIDEO
7modelTYPEMODEL
8otherTYPEOTHER

Кодировка (значения могут отличаться в зависимости от используемой библиотеки, так что рекомендуется использовать константы)
ЗначениеТипКонстанта
07bitENC7BIT
18bitENC8BIT
2BinaryENCBINARY
3Base64ENCBASE64
4Quoted-PrintableENCQUOTEDPRINTABLE
5otherENCOTHER

Список изменений

ВерсияОписание
8.1.0 Параметр imap теперь ожидает экземпляр класса IMAP\Connection; раньше параметр ждал ресурс (resource) imap.

Смотрите также

  • imap_fetchbody() - Извлекает конкретную секцию тела сообщения
  • imap_bodystruct() - Читает структуру указанной секции тела заданного сообщения
To Top