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 — Retourne un tableau de messages après recherche
Description
array imap_search
( resource $imap_stream
, string $criteria
[, int $options
[, string $charset
]] )
Effectue une recherche dans la boîte aux lettres courante, sur le flux IMAP courant.
Par exemple, pour rechercher les messages non répondus, envoyés par maman, vous pouvez utiliser : "UNANSWERED FROM maman". Les recherches semblent insensibles à la casse. Cette liste de critères est issue du code d'un client C UW et peut être incomplète ou imprécise. (voir aussi » RFC2060, section 6.4.4).
Liste de paramètres
- imap_stream
-
Un flux IMPA retourné par la fonction imap_open().
- criteria
-
Une chaîne de caractères, délimitée par des espaces, dans laquelle les mots-clés suivants sont acceptés. Tous les arguments à plusieurs mots (e.g. FROM "joey smith") doivent être placés entre guillemets :
- ALL - retourne tous les messages qui vérifient le reste du critère.
- ANSWERED - tous les messages avec le flag \\ANSWERED
- BCC "string" - tous les messages avec la chaîne "string" dans le champ Bcc
- BEFORE "date" - tous les messages avec Date : avant "date"
- BODY "string" - tous les messages avec "string" dans le corps
- CC "string" - tous les messages avec "string" dans le champ Cc
- DELETED - tous les messages effacés
- FLAGGED - tous les messages avec le flag \\FLAGGED (parfois interprété comme Important ou Urgent)
- FROM "string" - tous les messages avec la chaîne "string" dans le champ From
- KEYWORD "string" - tous les messages avec la chaîne "string" comme mot-clé
- NEW - tous les nouveaux messages
- OLD - tous les anciens messages
- ON "date" - tous les messages avec la date "date" comme champ Date
- RECENT - tous les messages avec le flag \\RECENT
- SEEN - tous les messages lus (avec le flag\\SEEN flag)
- SINCE "date" - tous les messages avec la date Date: après "date"
- SUBJECT "string" - tous les messages avec la chaîne "string" dans le champ Subject
- TEXT "string" - tous les messages avec le texte "string"
- TO "string" - tous les messages avec la chaîne "string" dans le champ To
- UNANSWERED - tous les messages non répondus
- UNDELETED - tous les messages non effacés
- UNFLAGGED - tous les messages non marqués
- UNKEYWORD "string" - tous les messages ne contenant pas le mot-clé "string"
- UNSEEN - tous les messages non lus
- options
-
Les valeurs pour les flags sont SE_UID, qui fait que le tableau réponse contient les UID plutôt que les numéros de séquence.
- charset
-
Valeurs de retour
Retourne un tableau de numéro de messages ou d'UID.
Retourne FALSE si la recherche n'est pas comprise, ou bien qu'aucun message n'a été trouvé.
Historique
| Version | Description |
|---|---|
| 4.3.3 | Le paramètre charset a été ajouté. |
add a note
User Contributed Notesimap_search
admin at rancid-tea dot com
20-Sep-2007 08:57
20-Sep-2007 08:57
oliver at samera dot com dot py
26-Oct-2002 08:16
26-Oct-2002 08: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
26-Jan-2002 09:03
26-Jan-2002 09: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";