imap_scanmailbox
This search looks for messages matching ALL criteria, not ANY criteria. For example the search
imap_search($mailbox,'FROM "user" TO "user"')
Will return message that have "user" in both the from and to headers, but not messages with "user" in either the from or to header.
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
add a note
User Contributed Notesimap_search
admin at rancid-tea dot com
20-Sep-2007 05:57
20-Sep-2007 05:57
oliver at samera dot com dot py
26-Oct-2002 05:16
26-Oct-2002 05:16
imap_search() only supports IMAP2 search criterias, because the function mail_criteria() (from c-client lib) is used in ext/imap/php_imap.c for parsing the search string.
IMAP2 search criteria is defined in RFC 1176, section "tag SEARCH search_criteria".
oliver at samera dot com dot py
27-Jan-2002 06:03
27-Jan-2002 06:03
imap_search() return false if it does not understand the search condition or no messages have been found.
$emails imap_seach($mbox, "UNDELETED SENTSINCE 01-Jan-2002");
if($emails === false)
echo "The search failed";