imap_search
(PHP 4, PHP 5)
imap_search — Retourne un tableau de messages apr�s recherche
Description
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 impr�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 � plusieurs mots (e.g. FROM "joey smith") doivent �tre plac�s 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 marqu�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 UID plut�t que les num�ros de s�quence.
- charset
-
Valeurs de retour
Retourne un tableau de num�ro de messages ou d'UID.
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�. |