Manuel PHP
Précédent |  | Suivant

# imap_search

(PHP 3 >= 3.0.12, PHP 4, PHP 5)

imap_search -- Retourne un tableau de message après recherche

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

Précédent | Sommaire | Suivant
imap_scanmailbox | Niveau supérieur | imap_set_quota