Учебник РНР
НазадВперёд

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

НазадОглавлениеВперёд
imap_scanmailboxВверхimap_set_quota