IMAP, POP3 및 NNTP imap_get_quota
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
imap_get_quota — 할당량 수준 설정 및 사서함당 사용량 통계 검색
설명
imap_get_quota(IMAP\Connection $imap
, string $quota_root
): array|false
할당량 수준 설정 및 사서함당 사용량 통계를 검색합니다.
이 함수의 관리자가 아닌 사용자 버전에 대해서는 PHP의 imap_get_quotaroot() 함수를 참조하십시오.
매개변수
imap
- IMAP\Connection 인스턴스입니다.
quota_root
quota_root
는 일반적으로 user.name 형식이어야 하며 여기서 name은 정보를 검색하려는 사서함입니다.
반환 값
지정된 사서함에 대한 정수 값 제한 및 사용량이 있는 배열을 반환합니다. limit 값은 이 사서함에 허용되는 총 공간을 나타냅니다. 사용량 값은 사서함의 현재 용량 수준을 나타냅니다. 실패의 경우 false
를 반환합니다.
PHP 4.3부터 이 함수는 » RFC2087에 명시된 대로 기능을 더 적절하게 반영합니다. 배열 반환 값은 개별 배열 키를 받는 각 명명된 리소스와 함께 반환된 리소스(즉, 메시지 또는 하위 폴더)를 무제한으로 지원하도록 변경되었습니다. 그런 다음 각 키 값에는 사용 및 제한 값이 포함된 다른 배열이 포함됩니다.
이전 버전과의 호환성을 위해 업데이트가 권장되지만 원래 액세스 방법을 계속 사용할 수 있습니다.
변경 로그
버전 | 설명 |
---|---|
8.1.0 | imap 매개변수는 이제 IMAP\Connection 인스턴스를 필요로 합니다. 이전에는 리소스가 필요했습니다. |
Examples
예제 #1 imap_get_quota() 예제
<?php
$mbox = imap_open("{imap.example.org}", "mailadmin", "password", OP_HALFOPEN)
or die("can't connect: " . imap_last_error());
$quota_value = imap_get_quota($mbox, "user.kalowsky");
if (is_array($quota_value)) {
echo "Usage level is: " . $quota_value['usage'];
echo "Limit level is: " . $quota_value['limit'];
}
imap_close($mbox);
?>
예제 #2 imap_get_quota() 4.3 이상 예
<?php
$mbox = imap_open("{imap.example.org}", "mailadmin", "password", OP_HALFOPEN)
or die("can't connect: " . imap_last_error());
$quota_values = imap_get_quota($mbox, "user.kalowsky");
if (is_array($quota_values)) {
$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 is: " . $message['limit'];
/* ... */
}
imap_close($mbox);
?>
메모
이 함수는 현재 c-client2000 이상의 라이브러리 사용자만 사용할 수 있습니다.
주어진 imap
은 메일 관리자로 열려 있어야 합니다. 그렇지 않으면 이 함수는 실패합니다.
기타
- imap_open() - mailbox에 대한 IMAP 스트림 열기
- imap_set_quota() - 지정된 mailbox에 대한 할당량을 설정합니다.
- imap_get_quotaroot() - 사용자별 할당량 설정 검색