['STORAGE']['usage'] and ['STORAGE']['limit'] are values in KB (1024 Bytes)
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
add a note
User Contributed Notes 3 notes
thomas dot hebinck at digionline dot de ¶
18 years ago
uphonesimon at gmail dot com ¶
16 years ago
just to make a note for all the people that are wondering the differences between $quota['STORAGE'] and $quot['MESSAGE']
the $quot['STORAGE'] is the size of the mailbox in KB
but $quota['MESSAGE'] is actually the number of messages stored in the mailbox and the up limit of the total messages allowed
rodrigo dot tsuru at tsuru dot net ¶
17 years ago
The example above isn't right. Replace with this:
<?php
$mbox = imap_open("{your.imap.host}", "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 usage level is: " . $message['limit'];
/* ... */
}
imap_close($mbox);
?>
