Описание функции imap-search
imap_search
(PHP 3>= 3.0.12, PHP 4)
imap_search - эта функция возвращает массив сообщений, совпадающих с данным критерием поиска.
Описание
array imap_search (int imap_stream, string criteria, int flags)
Эта функция выполняет поиск в mailbox'е, открытом в данный момент в imap-потоке.
criteria это строка, ограниченная пробелами, в которой допускается наличие ключевых слов. Любые многословные аргументы (например, FROM "joey smith") обязаны быть в кавычках.
-
ALL - возвращать все сообщения, соответствующие остальной части критерия -
ANSWERED - совпадать с сообщениями с установленным флагом \\ANSWERED -
BCC "string" - совпадать с сообщениями со "string" в поле Bcc: -
BEFORE "date" - совпадать с сообщениями с Date: перед "date" -
BODY "string" - совпадать с сообщениями со "string" в теле сообщения -
CC "string" - совпадать с сообщениями со "string" в поле Cc: -
DELETED - совпадать с удалёнными сообщениями -
FLAGGED - совпадать с сообщениями с установленным флагом \\FLAGGED (иногда называемым Important или Urgent) -
FROM "string" - совпадать с сообщениями со "string" в поле From: -
KEYWORD "string" - совпадать с сообщениями со "string" - ключевым словом -
NEW - совпадать с новыми сообщениями -
OLD - совпадать со старыми сообщениями -
ON "date" - совпадать с сообщениями с Date: совпадающей с "date" -
RECENT - совпадать с сообщениями с установленным флагом \\RECENT -
SEEN - совпадать с прочитанными сообщениями (установлен флаг \\SEEN) -
SINCE "date" - совпадать с сообщениями с Date: после "date" -
SUBJECT "string" - совпадать с сообщениями со "string" в поле Subject: -
TEXT "string" - совпадать с сообщениями с текстовой "string" -
TO "string" - совпадать с сообщениями со "string" в поле To: -
UNANSWERED - совпадать с сообщениями, на которые не дан ответ -
UNDELETED - совпадать с сообщениями, которые не удалены -
UNFLAGGED - совпадать с сообщениями, которые не помечены флагами -
UNKEYWORD "string" - совпадать с сообщениями, не имеющими ключевого слова "string" -
UNSEEN - совпадать с сообщениями, которые ещё не прочитаны
Например, чтобы найти все сообщения от Mom, на которые не даны ответы, можно использовать: "UNANSWERED FROM mom". Поиск происходит без учёта регистра. Этот список критериев взят из исходного кода UW c-клиента и может быть неполным и неточным (см. также RFC2060, раздел 6.4.4).
Правильными значениями флагов являются SE_UID, тогда возвращаемый массив содержит UID'ы вместо номеров последовательности сообщений.