2024 PHP Conference Japan

imap_get_quotaroot

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

imap_get_quotaroot擷取每個使用者的配額設定

說明

imap_get_quotaroot(IMAP\Connection $imap, string $mailbox): array|false

擷取每個使用者的配額設定。限制值表示允許此使用者所有信箱使用的總空間量。使用量值表示使用者目前的信箱總容量。

參數

imap

一個 IMAP\Connection 實例。

mailbox

mailbox 通常應該採用信箱的形式(例如 INBOX)。

返回值

傳回一個包含指定使用者信箱整數值的陣列。所有值都包含一個基於資源名稱的鍵,以及一個包含使用量和限制值的對應陣列。

如果呼叫失敗,此函式將傳回 false;如果伺服器傳回無法解析的回應,則會傳回一個包含連線資訊的陣列。

更新日誌

版本 說明
8.1.0 imap 參數現在需要一個 IMAP\Connection 實例;先前需要一個有效的 imap 資源

範例

範例 #1 imap_get_quotaroot() 範例

<?php
$mbox
= imap_open("{imap.example.org}", "kalowsky", "password", OP_HALFOPEN)
or die(
"無法連線: " . imap_last_error());

$quota = imap_get_quotaroot($mbox, "INBOX");
if (
is_array($quota)) {
$storage = $quota['STORAGE'];
echo
"STORAGE 使用量等級為: " . $storage['usage'];
echo
"STORAGE 限制等級為: " . $storage['limit'];

$message = $quota['MESSAGE'];
echo
"MESSAGE 使用量等級為: " . $message['usage'];
echo
"MESSAGE 限制等級為: " . $message['limit'];

/* ... */

}

imap_close($mbox);
?>

注意事項

此函式目前僅適用於 c-client2000 或更高版本函式庫的使用者。

imap 應該以您要檢查其信箱的使用者身分開啟。

參見

新增筆記

使用者貢獻的筆記 2 則筆記

thomas dot hebinck at digionline dot de
21 年前
['STORAGE']['usage'] 和 ['STORAGE']['limit'] 的值單位是 KB (1024 位元組)
uphonesimon at gmail dot com
19 年前
只是為所有想知道 $quota['STORAGE'] 和 $quot['MESSAGE'] 之間差異的人做個註記
$quot['STORAGE'] 是信箱的大小,單位為 KB
而 $quota['MESSAGE'] 實際上是儲存在信箱中的郵件數量以及允許的郵件總數上限
To Top