(PHP 4, PHP 5, PHP 7, PHP 8)
imap_listscan — Получает список почтовых ящиков, имена которых содержат заданную строку
Возвращает массив, содержащий имена почтовых ящиков содержащих content
в тексте.
Эта функция похожа на imap_listmailbox(), но также выявляет присутствие строки content
внутри данных почтового ящика.
imap
Экземпляр класса IMAP\Connection.
reference
В reference
, как правило, должна быть указана только спецификация сервера, как описано в imap_open()
Если imap.enable_insecure_rsh не отключён, то передача в этот параметр не проверенных данных не безопасна.
pattern
Определяет начало поиска в иерархии почтовых ящиков.
Есть два специальных символа, которые можно использовать при передаче как часть pattern
: '*
' и '%
'. '*
' возвращает все почтовые ящики. Если вы передадите pattern
как '*
', то получите полный список иерархии почтовых ящиков. '%
' вернёт только текущий уровень. '%
', переданный как параметр pattern
, вернёт почтовые ящики только на самом верхнем уровне; '~/mail/%
' на UW_IMAPD
вернёт все ящики в директории ~/mail, кроме тех, которые находятся в её поддиректориях.
content
Искомая строка
Возвращает массив, содержащий имена почтовых ящиков содержащих content
в тексте или false
, если возникла ошибка.
Версия | Описание |
---|---|
8.1.0 | Параметр imap теперь ожидает экземпляр класса IMAP\Connection; раньше параметр ждал ресурс (resource) imap . |