imap_fetch_overview

(PHP 4, PHP 5, PHP 7)

imap_fetch_overviewОбзор информации, содержащейся в заголовках сообщений

Описание

array imap_fetch_overview ( resource $imap_stream , string $sequence [, int $options = 0 ] )

Эта функция читает заголовки сообщений, задангных в sequence и вовзращают обзорную информацию об их контенте.

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

imap_stream

Поток IMAP, полученный из imap_open().

sequence

Последовательность номеров сообщений.Вы можете перечислить несколько сообщений используя как разделитель запятую (X,Y), или задать интервал сообщений с помощью двоеточия X:Y

options

Параметр sequence должен содержать номера сообщений. Если вы хотите задать в нем их UID, то этот параметр необходимо задать значением FT_UID.

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

Возвращает массив объектов, каждый из которых описывает заголовок одного сообщения. Объекты содержат соответствующие свойства только если они присутствуют. Возможные свойства:

  • subject - тема письма
  • from - кто его послал
  • to - получатель
  • date - когда оно было послано
  • message_id - Идентификатор сообщения
  • references - является ссылкой на этот идентификатор сообщения
  • in_reply_to - является ответом на письмо с этим идентификатором
  • size - размер в байтах
  • uid - UID сообщения в ящике
  • msgno - номер сообщения в ящике
  • recent - письмо помечено как новое
  • flagged - это сообщение помечено (обычно является признаком "важности")
  • answered - сообщение помечано как отвеченное
  • deleted - помечено для удаления
  • seen - помечено как прочитанное
  • draft - помечено как черновик
  • update - временная метка UNIX времени получения

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

Версия Описание
5.3.3 Добавлено свойство update.

Примеры

Пример #1 Пример использования imap_fetch_overview()

<?php
$mbox 
imap_open("{imap.example.org:143}INBOX""username""password")
     or die(
"can't connect: " 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);
?>

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