PHP Handbuch
Zurück |  | Weiter

# 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 | Weiter
imap_sort | Nach oben | imap_subscribe