(PHP 4, PHP 5)
imap_list — Lit la liste des boîtes aux lettres
$imap_stream
, string $ref
, string $pattern
)Lit la liste des boîtes aux lettres.
imap_streamUn flux IMAP retourné par la fonction imap_open().
ref
ref ne devrait être que le serveur
sous la forme décrite dans imap_open()
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 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.
Retourne un tableau contenant les noms des boîtes aux lettres.
Exemple #1 Exemple avec imap_list()
<?php
$mbox = imap_open("{imap.example.org}", "username", "password", OP_HALFOPEN)
or die("Connexion impossible : " . imap_last_error());
$list = imap_list($mbox, "{imap.example.org}", "*");
if (is_array($list)) {
foreach ($list as $val) {
echo imap_utf7_decode($val) . "\n";
}
} else {
echo "imap_list a échoué : " . imap_last_error() . "\n";
}
imap_close($mbox);
?>