(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
imap_get_quotaroot — ユーザー単位のクォータ設定を取得する
ユーザー単位のクォータ設定を取得します。 limit の値は、このユーザーがメールボックスで使用可能な総容量を表します。 usage の値は、ユーザーが現在メールボックスで使用している容量を表します。
imapIMAP\Connection クラスのインスタンス。
mailboxmailbox はどのメールボックスを調べるかを 指定します（例: INBOX）。
指定したユーザーのメールボックスに関連する整数値を配列で返します。 すべての値にはリソース名に基づいたキーがつけられており、 usage および limit 値を保持する配列が関連付けられています。
コールが失敗した場合、およびサーバーからの応答内容をパースできなかった場合には この関数は 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 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 は、 調べたいメールボックスを所有するユーザーがオープンしなければなりません。