(PHP 3>= 3.0.12, PHP 4, PHP 5)

imap_getmailboxes - читает список mailbox'ов, возвращает детальную информацию о каждом.

Описание

array imap_getmailboxes (int imap_stream, string ref, string pattern)

Возвращает массив объектов, содержащих информацию о mailbox'ах. Каждый объект имеет атрибуты: name, специфицирующий полное имя mailbox'а; delimiter, ограничитель иерархии для той части её, в которой находится данный mailbox; и attributes. Attributes это битовая маска, проверяемая относительно:

• LATT_NOINFERIORS - этот mailbox не имеет "потомков/children" (ниже него нет mailbox'ов).

• LATT_NOSELECT - это лишь контейнер, а не mailbox - вы не можете открыть его.

• LATT_MARKED - этот mailbox помечен. Используется только в UW-IMAPD.

• LATT_UNMARKED - этот mailbox не помечен. Используется только в UW-IMAPD.

Имена mailbox'ов, содржащие интернациональные символы за пределами печатаемого диапазона ASCII, будут кодированы и могут быть декодированы с помощью imap_utf7_decode().

ref нормально должен быть просто спецификацией сервера, как описано в imap_open(), а pattern специфицирует, где в иерархии mailbox'ов начинать поиск. Если вам нужны все mailbox'ы, передайте '*' для pattern.

Есть два специальных символа, которые вы можете передавать как часть pattern: '*' и '%'.
'*' означает: вернуть все mailbox'ы. Если вы передаёте pattern как '*', вы получите список всей иерархии mailbox'ов.
'%' означает: возвратить только текущий уровень. '%' как параметр pattern возвратит только mailbox'ы верхнего уровня; '~/mail/%' в UW_IMAPD will возвратит каждый mailbox в директории ~/mail, но не в подкаталогах данного каталога/директории.

$mbox = imap_open("{your.imap.host}","username","password",OP_HALFOPEN)  
or die("can't connect: ".imap_last_error());     
$list = imap_getmailboxes($mbox,"{your.imap.host}","*");  
if(is_array($list)) {  
reset($list); 
while (list($key, $val) = each($list))  {  
print "($key) ";  
print imap_utf7_decode($val->name).",";  
print "'".$val->delimiter."',";  
print $val->attributes."<br>\n";  }  } 
else  
print "imap_getmailboxes failed: ".imap_last_error()."\n";     
imap_close($mbox);