imap_get_quotaroot
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
imap_get_quotaroot — Liefert die Quota-Einstellungen für ein Benutzerpostfach
Beschreibung
Gibt die Quota-Einstellungen für den aktuellen Benutzer zurück. Die ermittelten Quota-Einstellungen gelten über alle Postfächer des Benutzers, der Nutzungswert für die aktuell im angegebenen Postfach genutzte Kapazität.
Parameter-Liste
-
imap -
Eine IMAP\Connection-Instanz.
-
mailbox -
Der Name des zu untersuchenden Postfachs, z. B. INBOX.
Rückgabewerte
Gibt ein Array zurück mit Ressourcennamen als Index und Arrays mit den Elementen limit und usage als Werte, 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.
Changelog
| Version | Beschreibung |
|---|---|
| 8.1.0 |
Der Parameter imap erwartet nun eine
IMAP\Connection-Instanz; vorher wurde eine Ressource
erwartet.
|
Beispiele
Beispiel #1 imap_get_quotaroot()-Beispiel
<?php
$mbox = imap_open("{imap.example.org}", "kalowsky", "password", OP_HALFOPEN)
or die("Kann keine Verbindung aufbauen: " . imap_last_error());
$quota = imap_get_quotaroot($mbox, "INBOX");
if (is_array($quota)) {
$storage = $quota['STORAGE'];
echo "Speicherplatz (aktuell genutzt): " . $storage['usage'];
echo "Speicherplatz (Limit): " . $storage['limit'];
$message = $quota['MESSAGE'];
echo "Anzahl Nachrichten (aktuell): " . $message['usage'];
echo "Anzahl Nachrichten (Limit): " . $message['limit'];
/* ... */
}
imap_close($mbox);
?>
Anmerkungen
Diese Funktion ist aktuell erst ab der Bibliotheksversion c-client2000 verfügbar.
Das zu prüfende Postfach muss dem Benutzer gehören, für den
imap geöffnet wurde.
Siehe auch
- imap_open() - Öffnet einen IMAP-Stream zu einem Postfach
- imap_set_quota() - Legt die Größenbeschränkung für ein Postfach fest
- imap_get_quota() - Liefert Quota-Einstellungen und Nutzungsstatistik der Postfächer
