Читает заголовок сообщения

# imap_headerinfo

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

imap_headerinfo — Читает заголовок сообщения

### Описание

function imap_headerinfo(
IMAP\Connection `$imap`,
int `$message_num`,
int `$from_length` = 0,
int `$subject_length` = 0
): stdClass|false

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

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

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

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

`from_length`

  Количество символов в свойстве `fetchfrom`. Должно быть больше или равно нулю.

`subject_length`

  Количество символов в свойстве `fetchsubject`. Должно быть больше или равно нулю.

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

В случае возникновения ошибки возвращает `false`. В случае успешного выполнения возвращает объект со следующими свойствами:

- toaddress - полная строка to:, максимум 1024 символов
- to - массив объектов из поля To:, со следующими свойствами: `personal`, `adl`, `mailbox` и `host`
- fromaddress - полная строка from:, максимум 1024 символов
- from - массив объектов из поля From:, со следующими свойствами: `personal`, `adl`, `mailbox` и `host`
- ccaddress - полная строка cc:, максимум 1024 символов
- cc - массив объектов из поля Cc:, со следующими свойствами: `personal`, `adl`, `mailbox` и `host`
- bccaddress - полная строка bcc:, максимум 1024 символов
- bcc - массив объектов из поля Bcc:, со следующими свойствами: `personal`, `adl`, `mailbox` и `host`
- reply_toaddress - полная строка Reply-To:, максимум 1024 символов
- reply_to - массив объектов из поля Reply-To:, со следующими свойствами: `personal`, `adl`, `mailbox` и `host`
- senderaddress - полная строка sender:, максимум 1024 символов
- sender - массив объектов из поля Sender:, со следующими свойствами: `personal`, `adl`, `mailbox` и `host`
- return_pathaddress - полная строка Return-Path:, максимум 1024 символов
- return_path - массив объектов из поля Return-Path:, со следующими свойствами: `personal`, `adl`, `mailbox` и `host`
- remail -
- date - Дата письма, как она указана в заголовке
- Date - То же, что и date
- subject - Тема письма
- Subject - То же, что и subject
- in_reply_to -
- message_id -
- newsgroups -
- followup_to -
- references -
- Recent - `R` если новое и прочитанное, `N` если новое и не прочитанное, ' ' если не новое.
- Unseen - `U` если НЕ прочитано и НЕ новое, ' ' если прочитано ИЛИ не прочитано и новое
- Flagged - `F` если отмечено, ' ' если нет
- Answered - `A` если отвечено, ' ' если нет
- Deleted - `D` если удалено, ' ' если нет
- Draft - `X` если черновик, ' ' если нет
- Msgno - Номер сообщения
- MailDate -
- Size - Размер сообщения
- udate - время отсылки в виде временной метки Unix
- fetchfrom - поле from, отформатированное в соответствии с `from_length`
- fetchsubject - поле subject, отформатированное в соответствии с `subject_length`

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

Версия | Описание
--- | ---
8.1.0 | Параметр `imap` теперь принимает объект IMAP\Connection; раньше параметр ждал ресурс (resource) `imap`.
8.0.0 | Неиспользуемый параметр `defaulthost` был удалён.

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

- imap_fetch_overview() - Считывает обзор информации из заголовков сообщений

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open