imap_status

Beschreibung

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_lasterror() . "\n"; } imap_close ($mbox);