PHP Handbuch
Zurück |  | Nach vorne

# imap_status

(3.0.4 - 3.0.18 only, PHP 4 >= 4.0.0)

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

Zurück | Zum Anfang | Nach vorne
imap_alerts | Nach oben | imap_utf7_decode