PHP 7.2.0 Release Candidate 4 Released

imap_get_quotaroot

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

imap_get_quotarootПолучить настройки квоты для каждого пользователя

Описание

array imap_get_quotaroot ( resource $imap_stream , string $quota_root )

Возвращает настройки квоты для каждого пользователя. Число с ключем "limit" определяет максимальный допустимый размер ящика. Число с ключем "usage" определяет текущий уровень использования.

Список параметров

imap_stream

Поток IMAP, полученный из imap_open().

quota_root

quota_root должно содержать имя ящика (например INBOX).

Возвращаемые значения

Возвращает массив целых чисел, относящихся к конкретному пользователю. В качестве ключей массива используются имена ресурсов, а в качестве значений массивы с ключами "limit" и "usage".

В случае ошибки эта функция вернет FALSE и массив информацйии о соединении в случае получения ответа, который она не сможет разобрать.

Примеры

Пример #1 Пример использования imap_get_quotaroot()

<?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);
?>

Примечания

Эта функция доступна только при успользовании библиотеки c-client2000 или новее.

Заданный поток imap_stream должен быть открыт под пользователем, чей ящик вы хотите проверить.

Смотрите также

  • imap_open() - Открывает поток IMAP к почтовому ящику
  • imap_set_quota() - Установить квоту для заданного почтового ящика
  • imap_get_quota() - Получить настройку уровня квоты и статистику использования почтовых ящиков

add a note add a note

User Contributed Notes 3 notes

up
3
uphonesimon at gmail dot com
12 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
up
3
thomas dot hebinck at digionline dot de
14 years ago
['STORAGE']['usage'] and ['STORAGE']['limit'] are values in KB (1024 Bytes)
up
0
rodrigo dot tsuru at tsuru dot net
13 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);
?>
To Top