Description

Lit les quotas des boîtes aux lettres ainsi que des statistiques sur chacune d'elles.

Pour une version utilisateur, non administrateur, de cette fonction, reportez-vous à la fonction imap_get_quotaroot().

Liste de paramètres

Valeurs de retour

Retourne un tableau contenant les valeurs de quota et courante de la boîte aux lettres quota_root. Le quota représente la taille maximale de votre boîte aux lettres. La valeur courante est l'espace actuellement utilisé par votre boîte aux lettres. imap_get_quota() retournera FALSE en cas d'échec.

Depuis PHP 4.3, la fonction reflète plus fidèlement les fonctionnalités édictée par la RFC2087. Le tableau retourné a changé pour supporter un nombre illimité de ressources retournées (i.e. messages ou sous-dossiers) avec chaque ressource nommée qui est identifiée par une clé. Chaque clé contient alors un autre tableau avec l'utilisation et le quota. L'exemple ci-dessous montre comment l'utiliser.

Pour des raisons de compatibilité, la méthode d'accès originale est toujours disponible, mais il est recommandé de l'abandonner.

Exemples

Exemple 1. Exemple avec imap_get_quota() <?php $mbox = imap_open("{imap.example.org}", "mailadmin", "password", OP_HALFOPEN)       or die("Impossible de se connecter : " . imap_last_error()); $quota_value = imap_get_quota($mbox, "user.kalowsky"); if (is_array($quota_value)) {     echo "Niveau d'utilisation : " . $quota_value['usage'];     echo "Quota : " . $quota_value['limit']; } imap_close($mbox); ?>

Exemple 2. Exemple avec imap_get_quota() 4.3 ou supérieur <?php $mbox = imap_open("{imap.example.org}", "mailadmin", "password", OP_HALFOPEN)       or die("Impossible de se connecter : " . imap_last_error()); $quota_values = imap_get_quota($mbox, "user.kalowsky"); if (is_array($quota_values)) {    $storage = $quota_values['STORAGE'];    echo "Utilisation actuelle de la capacité de stockage : " .  $storage['usage'];    echo "Quota actuel de stockage  : " .  $storage['limit'];    $message = $quota_values['MESSAGE'];    echo "Niveau d'utilisation de MESSAGE  : " .  $message['usage'];    echo "Quota de MESSAGE : " .  $message['limit'];    /* ...  */ } imap_close($mbox); ?>

Notes

imap_get_quota() ne fonctionne actuellement qu'avec les bibliothèques c-client2000.

imap_stream doit avoir été créé avec la fonction imap_open(). Ce flux est nécessairement ouvert en tant qu'administrateur du serveur, pour que les droits nécessaires lui soient alloués.

Voir aussi