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