PHP Handbuch
Zurück |  | Nach vorne

# imap_status

(PHP 3>= 3.0.4, PHP 4 , PHP 5)

imap_status -- Liefert ausgewählte Statusinformationen zum angegebenen Postfach

## Beschreibung

object imap_status ( int imap_stream, string mailbox, int options)

Diese Funktion liefert Statusinformationen zum mit `mailbox` angegebenen Postfach. Im der Bitmaske `options` können dabei folgende Funktionen ausgewählt werden, die den Inhalt des zurückgegebenen Objekts beeinflussen:

- SA_MESSAGES - das Feld messages wird mit der Anzahl der enthaltenen Nachrichten gefüllt

- SA_RECENT - das Feld recent wird mit der Anzahl der neuen Nachrichten gefüllt

- SA_UNSEEN - das Feld unseen wird mit der Anzahl der noch nicht abgerufenen Nachrichten gefüllt

- SA_UIDNEXT - das Feld uidnext wird mit der UID gefüllt, die die nächste in diesem Postfach abgelegte Nachricht erhalten wird

- SA_UIDVALIDITY - das Feld uidvalidity wird mit einer Konstanten gefüllt, die sich immer dann verändern wird, wenn die UIDs der Nachrichten im Postfach sich vermutlich verändert haben

- SA_ALL - es werden alle beschriebenen Felder gefüllt

Status->flags wird ebenfalls gesetzt und enthält eine Bitmaske aus den oben genannten Werten, die die tatsächlich zurückgegebenen Informationen beschreibt.

Beispiel 1. imap_status() Beispiel
`$mbox = imap_open ("{your.imap.host}", "username", "password", OP_HALFOPEN) || die ("can't connect: " . imap_last_error()); $status = imap_status ($mbox, "{your.imap.host}INBOX", SA_ALL); if($status) { print ("Messages: " . $status->messages ) . "<br>\n"; print ("Recent: " . $status->recent ) . "<br>\n"; print ("Unseen: " . $status->unseen ) . "<br>\n"; print ("UIDnext: " . $status->uidnext ) . "<br>\n"; print ("UIDvalidity: " . $status->uidvalidity) . "<br>\n"; } else { print "imap_status failed: " . imap_last_error() . "\n"; } imap_close ($mbox);`

Zurück | Zum Anfang | Nach vorne
imap_sort | Nach oben | imap_subscribe