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
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