imap_search
(PHP 4, PHP 5)
imap_search —
Esta función devuelve un array de mensajes que coinciden con el
criterio de busqueda dado.
Descripción
array imap_search
( int $imap_stream
, string $criteria
, int $flags
)
Esta función realiza una busqueda en el buzón actualmente abierto
indicado por imap_stream. criteria
es una
cadena, delimitada por espacios, en la cual las siguientes palabras
claves son permitidas. Cualquier argumento múltiple (ej. FROM "joey smith") debe estar
entre comillas.
-
ALL - devuelve todos los mensajes que coinciden con el resto del criterio
-
ANSWERED - busca mensajes con el flag \\ANSWERED activado
-
BCC "string" - busca mensajes con "cadena" en el campo Bcc:
-
BEFORE "date" - busca mensajes con Date: antes de "date"
-
BODY "string" - busca mensajes con "cadena" en el cuerpo del mensaje
-
CC "string" - busca mensajes con "cadena" en el campo Cc:
-
DELETED - busca mensajes eliminados
-
FLAGGED - busca mensajes con el flag \\FLAGGED (sometimes
referred to as Important or Urgent) activado
-
FROM "string" - busca mensajes con "cadena" en el campo From:
-
KEYWORD "string" - busca mensajes con "cadena" como una palabra clave
-
NEW - busca mensajes nuevos
-
OLD - busca mensajes viejos
-
ON "date" - busca mensajes con "date" igual a Date:
-
RECENT - busca mensajes con el flag \\RECENT activado
-
SEEN - busca mensajes que han sido leidos (la opcion \\SEEN activada)
-
SINCE "date" - busca mensajes conwith Date: after "date"
-
SUBJECT "string" - busca mensajes con "string" en el campo Subject:
-
TEXT "string" - busca mensajes con el texto "string"
-
TO "string" - busca mensajes con "string" en el campo To:
-
UNANSWERED - busca mensajes que no han sido respondidos
-
UNDELETED - busca mensajes que no han sido eliminados
-
UNFLAGGED - busca mensajes que no estan flagged
-
UNKEYWORD "string" - busca mensajes que no coinciden con la palabra
clave "string"
-
UNSEEN - busca mensajes que no han sido leidos aún
Por ejemplo, para buscar todos los mensajes no contestados enviados por
Mamá, usaría: "UNANSWERED FROM mamá". La busqueda parece ser no sensitiva.
Esta lista de criterios está tomada del codigo fuente del UW
c-client y puede que este incompleta o sea inexacta.
Valores validos para los flags son SE_UID, que provoca que el array
devuelto contenga UIDs en vez de los numeros de secuencia de los mensajes