imap_get_quotaroot

(PHP 4 >= 4.3.0, PHP 5)

imap_get_quotaroot -- Liefert die Quota-Beschränkungen für ein Benutzerpostfach

Beschreibung

array imap_get_quotaroot ( resource 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

An IMAP stream returned by imap_open().

quota_root

Name des zu untersuchenden Postfachs, z.b. INBOX.

Rückgabewerte

Liefert ein Array mit Resourcenamen als Index und Arrays mit den Elementen limit und useage als Werten die das aktuelle Limit sowie die tatsächliche Nutzung der jeweiligen Resource 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_values['STORAGE'];
   echo
"STORAGE usage level is: " .  $storage['usage'];
   echo
"STORAGE limit level is: " .  $storage['limit'];

   
$message = $quota_values['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 denn imap_stream geöffnet wurde.

Siehe auch

imap_open()
imap_set_quota()
imap_get_quota()