imap_fetch_overview
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_fetch_overview — Liefert eine Zusammenfassung der Kopfdaten von Nachrichten
Beschreibung
Die Funktion fragt die Kopfdaten der mit sequence() angegebenen Nachrichten ab und gibt eine Zusammenfassung darüber zurück.
Parameter-Liste
-
imap -
Eine IMAP\Connection-Instanz.
-
sequence -
Die Beschreibung der gewünschten Nachrichten. Mehrere Nachrichten können durch Komma getrennt angegeben werden (
X,Y), Nachrichtenbereiche durch einen Doppelpunkt zwischen der ersten und der letzten Nachricht (X:Y). -
flags -
Wenn dieser Parameter auf
FT_UIDgesetzt wird, werden die einzelnen Einträge der Nachrichtenlistesequenceals UIDs und nicht als Nachrichtennummern interpretiert.
Rückgabewerte
Gibt ein Array von Objekten zurück, die jeweils den Nachrichtenkopf einer Nachricht beschreiben. Das Objekt hat eine Eigenschaft nur dann, wenn sie auch existiert. Die möglichen Eigenschaften sind:
-
subject- die Betreffzeile der Nachricht -
from- der Absender -
to- der Empfänger -
date- der Sendezeitpunkt -
message_id- die ID der Nachricht -
references- die Referenz auf die Nachricht mit dieser ID -
in_reply_to- die Antwort auf die Nachricht mit dieser ID -
size- die Größe in Bytes -
uid- die UID innerhalb des Postfachs -
msgno- die aktuelle Nachrichtennummer innerhalb des Postfachs -
recent- diese Nachricht ist als kürzlich eingetroffen markiert -
flagged- diese Nachricht ist als wichtig markiert -
answered- diese Nachricht ist als beantwortet markiert -
deleted- diese Nachricht ist zur Löschung vorgemerkt -
seen- diese Nachricht ist als bereits gelesen markiert -
draft- diese Nachricht ist als Entwurf markiert -
udate- der UNIX-Zeitstempel des Ankunftsdatums
false zurück.
Changelog
| Version | Beschreibung |
|---|---|
| 8.1.0 |
Der Parameter imap erwartet nun eine
IMAP\Connection-Instanz; vorher wurde eine Ressource
erwartet.
|
Beispiele
Beispiel #1 imap_fetch_overview()-Beispiel
<?php
$mbox = imap_open("{imap.example.org:143}INBOX", "username", "password")
or die("Kann keine Verbindung aufbauen: " . imap_last_error());
$MC = imap_check($mbox);
// Rufe eine Übersicht aller Nachrichten im Eingangspostfach INBOX ab
$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);
?>
