7.41.58 imap_search()
Retourne un tableau de message après recherche.
[ Exemples avec imap_search ] PHP 3>= 3.0.12, PHP 4
array
imap_search (
resource
imap_stream
,
string
criteria
,
int
options
)
imap_search
effectue une recherche dans la boîte aux
lettres courante, sur le flôt
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
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 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 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 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.
|