(PHP 4, PHP 5, PHP 7, PHP 8)
imap_fetch_overview — Обзор информации, содержащейся в заголовках сообщений
Эта функция читает заголовки сообщений, заданных в
sequence
и возвращает обзорную информацию
об их контенте.
imap
Экземпляр IMAP\Connection.
sequence
Последовательность номеров сообщений.Вы можете перечислить несколько
сообщений, используя как разделитель запятую (X,Y
), или
задать интервал сообщений с помощью двоеточия X:Y
flags
Параметр sequence
должен содержать номера сообщений.
Если вы хотите задать в нем их UID, то этот параметр необходимо
задать значением FT_UID
.
Возвращает массив объектов, каждый из которых описывает заголовок одного сообщения. Объекты содержат соответствующие свойства только если они присутствуют. Возможные свойства:
subject
- тема письма
from
- кто его послал
to
- получатель
date
- когда оно было послано
message_id
- Идентификатор сообщения
references
- является ссылкой на этот идентификатор сообщения
in_reply_to
- является ответом на письмо с этим идентификатором
size
- размер в байтах
uid
- UID сообщения в ящике
msgno
- номер сообщения в ящике
recent
- письмо помечено как новое
flagged
- это сообщение помечено (обычно является признаком
"важности")
answered
- сообщение помечено как отвеченное
deleted
- помечено для удаления
seen
- помечено как прочитанное
draft
- помечено как черновик
udate
- временная метка UNIX даты получения
false
в случае возникновения ошибки.
Версия | Описание |
---|---|
8.1.0 |
Параметр imap теперь ожидает экземпляр IMAP\Connection; ранее ожидался ресурс (resource) imap .
|
Пример #1 Пример использования imap_fetch_overview()
<?php
$mbox = imap_open("{imap.example.org:143}INBOX", "username", "password")
or die("не удалось подключиться: " . imap_last_error());
$MC = imap_check($mbox);
// Получим обзор всех писем в INBOX
$result = imap_fetch_overview($mbox,"1:{$MC->Nmsgs}",0);
foreach ($result as $overview) {
echo "#{$overview->msgno} ({$overview->date}) - From: {$overview->from}
{$overview->subject}\n";
}
imap_close($mbox);
?>