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);