Manuel PHP
Précédent |  | Suivant

# imap_search

(PHP 3 >= 3.0.12, 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 inpré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 multi-mots (e.g. FROM "joey smith") 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

`options`

  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.

`charset`

## Valeurs de retour

Retourne un tableau de numéro de messages ou d'UIDs.

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

## Voir aussi

imap_listscan()

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