(PHP 4, PHP 5, PHP 7, PHP 8)
imap_listscan — Lit la liste des boîtes aux lettres, et y recherche une chaîne
$imap,$reference,$pattern,$content
Retourne un tableau contenant les noms des boîtes aux lettres
qui contiennent la chaîne content
dans leur nom.
Cette fonction est similaire à imap_listmailbox(),
mais va aussi vérifier la présence de la chaîne content
dans les messages de la boîte aux lettres.
imapUne instance de IMAP\Connection.
reference
reference ne devrait être que le serveur
sous la forme décrite dans imap_open()
Passer des données qui ne sont pas digne de confiance à ce paramètre est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
patternSpécifie la position dans la hiérarchie des boîtes aux lettres, où il faut commencer à chercher.
Il y a deux caractères
spéciaux que vous pouvez utiliser dans pattern :
'*' et '%'.
'*' signifie : toutes les boîtes aux lettres. Si vous passez
pattern comme '*', vous obtiendrez
la liste complète des boîtes aux lettres de la hiérarchie.
'%' signifie qu'on ne s'intéresse qu'au niveau courant.
'%' passé à pattern ne retournera
que les boîtes aux lettres de niveau supérieur; '~/mail/%'
sous UW_IMAPD retournera toutes les boîtes aux lettres du
dossier ~/mail directory, mais pas leurs enfants.
contentLa chaîne cherchée
Retourne un tableau contenant les noms des boîtes aux lettres
qui contiennent la chaîne content
dans le nom de la boîte aux lettres, ou false si une erreur survient.
| Version | Description |
|---|---|
| 8.1.0 |
La paramètre imap attend désormais une instance de
IMAP\Connection ; auparavant, une resource imap était attendue.
|