(PHP 4, PHP 5, PHP 7, PHP 8)
imap_fetch_overview — Read an overview of the information in the headers of the given message
$imap
, string $sequence
, int $flags
= 0): array|false
This function fetches mail headers for the given
sequence
and returns an overview of their
contents.
imap
IMAP\Connection 实例。
sequence
A message sequence description. You can enumerate desired messages
with the X,Y
syntax, or retrieve all messages
within an interval with the X:Y
syntax
flags
sequence
will contain a sequence of message
indices or UIDs, if this parameter is set to
FT_UID
.
Returns an array of objects describing one message header each. The object will only define a property if it exists. The possible properties are:
subject
- the messages subject
from
- who sent it
to
- recipient
date
- when was it sent
message_id
- Message-ID
references
- is a reference to this message id
in_reply_to
- is a reply to this message id
size
- size in bytes
uid
- UID the message has in the mailbox
msgno
- message sequence number in the mailbox
recent
- this message is flagged as recent
flagged
- this message is flagged
answered
- this message is flagged as answered
deleted
- this message is flagged for deletion
seen
- this message is flagged as already read
draft
- this message is flagged as being a draft
udate
- the UNIX timestamp of the arrival date
false
on failure.
版本 | 说明 |
---|---|
8.1.0 |
现在 imap 参数接受 IMAP\Connection
实例,之前接受 资源(resource)。
|
示例 #1 imap_fetch_overview() example
<?php
$mbox = imap_open("{imap.example.org:143}INBOX", "username", "password")
or die("can't connect: " . imap_last_error());
$MC = imap_check($mbox);
// Fetch an overview for all messages in 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);
?>