array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.imap-fetch-overview.php', 1 => 'imap_fetch_overview', ), 'up' => array ( 0 => 'ref.imap.php', 1 => 'Функции IMAP', ), 'prev' => array ( 0 => 'function.imap-expunge.php', 1 => 'imap_expunge', ), 'next' => array ( 0 => 'function.imap-fetchbody.php', 1 => 'imap_fetchbody', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/imap/functions/imap-fetch-overview.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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);
?>