(PHP 4, PHP 5, PHP 7)
readdir — Lit une entrée du dossier
$dir_handle
] )
readdir() retourne le nom de la prochaine entrée
du dossier identifié par dir_handle.
Les entrées sont retournées dans l'ordre dans lequel elles sont enregistrées
dans le système de fichiers.
Retourne le nom de l'entrée en cas de réussite ou FALSE si une erreur survient.
Cette fonction peut
retourner FALSE, mais elle peut aussi retourner une valeur équivalent à
FALSE. Veuillez lire la section sur
les booléens pour plus d'informations.
Utilisez l'opérateur ===
pour tester la valeur de retour exacte de cette fonction.
Exemple #1 Liste de toutes les entrées d'un dossier
Notez la façon dont la valeur de retour de dir()
est vérifiée dans l'exemple suivant. Nous testons si la valeur est
identique (égale et de même type que -- voyez opérateurs de comparaison
pour plus de détails) FALSE sinon, toute entrée dans le nom serait évalué
à FALSE causera l'arrêt de la boucle (exemple, un répertoire nommé 0).
<?php
if ($handle = opendir('/chemin/vers/fichiers')) {
echo "Gestionnaire du dossier : $handle\n";
echo "Entrées :\n";
/* Ceci est la façon correcte de traverser un dossier. */
while (false !== ($entry = readdir($handle))) {
echo "$entry\n";
}
/* Ceci est la MAUVAISE façon de traverser un dossier. */
while ($entry = readdir($handle)) {
echo "$entry\n";
}
closedir($handle);
}
?>
Exemple #2 Liste toutes les entrées du dossier courant et enlève les . et ..
<?php
if ($handle = opendir('.')) {
while (false !== ($entry = readdir($handle))) {
if ($entry != "." && $entry != "..") {
echo "$entry\n";
}
}
closedir($handle);
}
?>