imap_search

Description

array imap_search ( resource imap_stream, string criteria [, int options [, string charset]] )

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.