Описание

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, но не в подкаталогах данного каталога/директории.

Содержание раздела

---

---