(PHP 4, PHP 5, PHP 7, PHP 8)
imap_fetch_overview — Read an overview of the information in the headers of the given message
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 实例,之前接受有效的 imap 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);
?>