|
(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'ы вместо номеров последовательности сообщений.
|
|