(PHP 3>= 3.0.12, PHP 4 )
imap_search -- Esta función devuelve un array de mensajes que coinciden con el criterio de busqueda dado.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