imap_search() effectue une recherche dans la boîte aux lettres courante, sur le flux IMAP courant. criteria est une chaîne, délimitée par des espaces, dans laquelle les mots-clés suivants sont acceptés. Tous les arguments multi-mots doivent être 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 flaggés
UNKEYWORD "string" - tous les messages ne contenant pas le mot-clé "string"
UNSEEN - tous les messages non lus
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 inprécise. (voir aussi RFC2060, section 6.4.4).
Les valeurs pour les flags sont SE_UID, qui fait que le tableau réponse contient les UIDs plutôt que les numéros de séquence.
Le paramètre charset a été ajouté en PHP 4.3.3.
| Précédent | Sommaire | Suivant |
| imap_scanmailbox | Niveau supérieur | imap_set_quota |