imap_mailboxmsginfo
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_mailboxmsginfo — Liefert Informationen zum aktuellen Postfach
Beschreibung
Prüft den aktuelle Status des Postfachs auf dem Server. Die Funktion ist vergleichbar mit imap_status(), gibt aber zusätzlich auch die Gesamtgröße aller Nachrichten in Bytes zurück. Das Aufsummieren der einzelnen Nachrichtengrößen benötigt dabei zusätzliche Zeit zur Ausführung.
Rückgabewerte
Die Ergebnisse werden in einem Objekt mit folgenden Eigenschaften zurückgegeben:
Date | Zeitpunkt der letzten Änderung (aktuelle Zeit) |
Driver | Treiber |
Mailbox | Name des Postfachs |
Nmsgs | Anzahl der Nachrichten |
Recent | Anzahl der kürzlich eingetroffenen Nachrichten |
Unread | Anzal der ungelesenen Nachrichten |
Deleted | Anzahl der gelöschten Nachrichten |
Size | Gesamtgröße des Postfachs in Bytes |
Gibt bei einem Fehler false
zurück.
Changelog
Version | Beschreibung |
---|---|
8.1.0 |
Der Parameter imap erwartet nun eine
IMAP\Connection-Instanz; vorher wurde eine Ressource
erwartet.
|
Beispiele
Beispiel #1 imap_mailboxmsginfo()-Beispiel
<?php
$mbox = imap_open("{imap.example.org}INBOX", "username", "password")
or die("Kann keine Verbindung aufbauen: " . imap_last_error());
$check = imap_mailboxmsginfo($mbox);
if ($check) {
echo "Datum: " . $check->Date . "<br />\n" ;
echo "Treiber: " . $check->Driver . "<br />\n" ;
echo "Postfach: " . $check->Mailbox . "<br />\n" ;
echo "Nachrichten: " . $check->Nmsgs . "<br />\n" ;
echo "Neueste: " . $check->Recent . "<br />\n" ;
echo "Ungelesen: " . $check->Unread . "<br />\n" ;
echo "Gelöscht: " . $check->Deleted . "<br />\n" ;
echo "Größe: " . $check->Size . "<br />\n" ;
} else {
echo "imap_mailboxmsginfo() schlug fehl: " . imap_last_error() . "<br />\n";
}
imap_close($mbox);
?>