(PHP 4, PHP 5, PHP 7)
imap_search — Получить сообщения, удовлетворяющие заданным критериям
$imap_stream
, string $criteria
[, int $options = SE_FREE
[, string $charset = NULL
]] ) : arrayЭта функция производит поиск в текущем почтовом ящике открытом в потоке IMAP.
К примеру, чтобы найти все неотвеченные сообщения посланные от мамы (Mom), нужно будет использовать "UNANSWERED FROM mom". Поиск регистронезависимый. Приведенный список критериев извлечен из исходных кодов UW c-client и может быть неполным или не совсем точным (дополнительно смотрите » RFC2060, секция 6.4.4).
imap_streamПоток IMAP, полученный из imap_open().
criteria
Строка, разделенная пробелами, в которой допустимо использовать следующие
ключевые слова. Любые аргументы, состоящие из нескольких слов, должны
быть заключены в двойные кавычки (например
FROM "joey smith"). Результат будет совпадать со всеми
заданными в параметре criteria критериями.
options
Корректные значения options - это
SE_UID, что приведет к тому, что в возвращенном
массиве вместо номеров сообщений будут содержаться их UID.
charsetКодировка MIME, в которой будет происходить поиск.
Возвращает номера сообщений или их UID.
Возвращает FALSE, если сообщения не найдены, либо критерии указанные
в criteria некорректны.
Пример #1 Пример использования imap_search()
<?php
$conn = imap_open('{imap.example.com:993/imap/ssl}INBOX', '[email protected]', 'pass123', OP_READONLY);
$some = imap_search($conn, 'SUBJECT "HOWTO be Awesome" SINCE "8 August 2008"', SE_UID);
$msgnos = imap_search($conn, 'ALL');
$uids = imap_search($conn, 'ALL', SE_UID);
print_r($some);
print_r($msgnos);
print_r($uids);
?>
Результатом выполнения данного примера будет что-то подобное:
Array
(
[0] => 4
[1] => 6
[2] => 11
)
Array
(
[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 5
[5] => 6
)
Array
(
[0] => 1
[1] => 4
[2] => 6
[3] => 8
[4] => 11
[5] => 12
)