Manuel PHP
Précédent |  | Suivant

# imap_search

(3.0.12 - 3.0.18 only, PHP 4 >= 4.0.0)

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

## Description

``array imap_search` (resource imap_stream, string criteria, int flags)`

imap_search() effectue une recherche dans la boîte aux lettres courante, sur le flot 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 message qui vérifie 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 champs 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 champs 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" dan le champs From:

- KEYWORD "string" - tous les messags 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 champs 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 champs Subject:

- TEXT "string" - tous les messages avec le texte "string"

- TO "string" - tous les messages avec la chaîne "string" dans le champs 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 dans le mot clés "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.

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