imap_get_quotaroot
(PHP 4 >= 4.3.0, PHP 5)
imap_get_quotaroot — Liefert die Quota-Beschränkungen für ein Benutzerpostfach
Beschreibung
$imap_stream
, string $quota_root
)Liefert die Quota-Beschränkungen für den aktuellen Benutzer. Die ermittelten Quota-Beschränkungen gelten über alle Postfächer des Benutzers, die Ausnutungswerte der im angegebenen Postfach genutzten Kapazität.
Parameter-Liste
-
imap_stream -
Eine von imap_open() zurückgegebene IMAP-Verbindung.
-
quota_root -
Name des zu untersuchenden Postfachs, z.B. INBOX.
Rückgabewerte
Liefert ein Array mit Ressourcenamen als Index und Arrays mit den Elementen limit und usage als Werten die das aktuelle Limit sowie die tatsächliche Nutzung der jeweiligen Ressource für das angegebene Postfach angeben.
Die Funktion gibt FALSE zurück, wenn Fehler auftreten und ein
Array mit Verbindungsinformationen, falls die Antwort des Servers
nicht verarbeitet werden konnte.
Beispiele
Beispiel #1 imap_get_quotaroot()-Beispiel
<?php
$mbox = imap_open("{imap.example.org}", "kalowsky", "password", OP_HALFOPEN)
or die("can't connect: " . imap_last_error());
$quota = imap_get_quotaroot($mbox, "INBOX");
if (is_array($quota)) {
$storage = $quota['STORAGE'];
echo "STORAGE usage level is: " . $storage['usage'];
echo "STORAGE limit level is: " . $storage['limit'];
$message = $quota['MESSAGE'];
echo "MESSAGE usage level is: " . $message['usage'];
echo "MESSAGE limit level is: " . $message['limit'];
/* ... */
}
imap_close($mbox);
?>
Anmerkungen
Diese Funktion ist nur verfügbar ab der Bibliotheksversion c-client2000.
Das zu prüfende Postfach muss dem User gehören, für den
imap_stream geöffnet wurde.
Siehe auch
- imap_open() - Öffnet eine Verbindung zu einem Mailserver-Postfach
- imap_set_quota() - Setzt die Mengenbeschränkung für ein Postfach
- imap_get_quota() - Liefert Quota-Beschränkungen und Nutzungsstatistik der Postfächer