imap_listscan
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_listscan — Lit la liste des boîtes aux lettres, et y recherche une chaîne
Description
IMAP\Connection
$imap,string
$reference,string
$pattern,string
$content): array|false
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.
Liste de paramètres
-
imap -
Une instance de IMAP\Connection.
-
reference -
referencene devrait être que le serveur sous la forme décrite dans imap_open()AvertissementPasser des données qui ne sont pas digne de confiance à ce paramètre est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
-
pattern -
Spé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 passezpatterncomme '*', 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é àpatternne retournera que les boîtes aux lettres de niveau supérieur; '~/mail/%' sousUW_IMAPDretournera toutes les boîtes aux lettres du dossier ~/mail directory, mais pas leurs enfants. -
content -
La chaîne cherchée
Valeurs de retour
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.
Historique
| Version | Description |
|---|---|
| 8.1.0 |
La paramètre imap attend désormais une instance de
IMAP\Connection ; auparavant, une ressource imap était attendue.
|
Voir aussi
- imap_listmailbox() - Alias de imap_list
- imap_search() - Retourne un tableau de messages après recherche
add a note
