imap_sort

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_sortOrdena mensajes

Descripción

imap_sort(
    IMAP\Connection $imap,
    int $criteria,
    bool $reverse,
    int $flags = 0,
    ?string $search_criteria = null,
    ?string $charset = null
): array|false

Recupera y ordena los números de mensajes en función de los parámetros dados.

Parámetros

imap

An IMAP\Connection instance.

criteria

Los criterios criteria pueden ser uno (y solo uno) de los siguientes:

  • SORTDATE : fecha del mensaje
  • SORTARRIVAL : fecha de llegada
  • SORTFROM : nombre del primer buzón de la dirección de origen (From address)
  • SORTSUBJECT : asunto del mensaje
  • SORTTO : nombre del primer buzón de destino (To address)
  • SORTCC : nombre del buzón de copia oculta (cc address)
  • SORTSIZE : tamaño del mensaje en bytes

reverse

Si se debe ordenar en orden inverso.

flags

Los flags son máscaras de bits, de uno o más de los siguientes elementos:

  • SE_UID : devuelve UID en lugar de números
  • SE_NOPREFETCH : no predescargar los mensajes encontrados

search_criteria

Criterios de búsqueda en formato IMAP2. Para más detalles ver imap_search().

charset

Conjunto de caracteres MIME a utilizar durante la búsqueda de string.

Valores devueltos

Devuelve un array de números de mensajes ordenados en función de los parámetros proporcionados, o false en caso de error.

Historial de cambios

Versión Descripción
8.1.0 The imap parameter expects an IMAP\Connection instance now; previously, a valid imap recurso was expected.
8.0.0 reverse es un bool en lugar de int.
8.0.0 search_criteria y charset son ahora nullable.