(PHP 4, PHP 5, PHP 7, PHP 8)
imap_sort — Получить и отсортировать сообщения
$imap
,$criteria
,$reverse
,$flags
= 0,$search_criteria
= null
,$charset
= null
Получает и сортирует номера сообщений в соответствии с заданными параметрами.
imap
Экземпляр IMAP\Connection.
criteria
Одно (и только одно) из следующих значений:
SORTDATE
- сортировать по дате
SORTARRIVAL
- дата получения
SORTFROM
- по первому адресу в поле From
SORTSUBJECT
- по теме письма
SORTTO
- по первому адресу в поле To
SORTCC
- по первому адресу в поле cc
SORTSIZE
- по размеру сообщения
reverse
Определяет сортировку в обратном порядке.
flags
Параметр flags
задаётся битовой маской одной
или нескольких констант:
SE_UID
- возвращать UID, а не номера сообщений
SE_NOPREFETCH
- не извлекать найденные сообщения
search_criteria
Строка с поисковым критерием в формате IMAP2. Подробнее смотрите в описании функции imap_search().
charset
Кодировка MIME для использования при сортировке строк.
Возвращает массив номеров сообщений, отсортированных в соответствии с заданными
параметрами или false
в случае возникновения ошибки.
Версия | Описание |
---|---|
8.1.0 |
Параметр imap теперь ожидает экземпляр IMAP\Connection; ранее ожидался ресурс (resource) imap .
|
8.0.0 |
reverse теперь является логическим типом (bool) вместо целого числа (int).
|
8.0.0 |
search_criteria и charset теперь являются nullable.
|