readdir

(PHP 3, PHP 4 , PHP 5)

readdir -- Lit une entrée du dossier

Description

string readdir ( resource dir_handle )

readdir() retourne le nom du fichier suivant dans le dossier identifié par dir_handle. Les noms sont retournés dans n'importe quel ordre.

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 -- woyez 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).

Exemple 1. Liste tous les fichiers du dossier courant

<?php
// Notez que !== n'existait pas avant 4.0.0-RC2

if ($handle = opendir('/chemin/vers/fichiers')) {
    echo
"Directory handle: $handle\n";
    echo
"Files:\n";

    
/* Ceci est la façon correcte de traverser un dossier. */
    
while (false !== ($file = readdir($handle))) {
        echo
"$file\n";
    }

    
/* Ceci est la MAUVAISE façon de traverser un dossier. */
    
while ($file = readdir($handle)) {
        echo
"$file\n";
    }

    
closedir($handle);
}
?>

Notez que readdir() retournera aussi les dossiers "." et "..". Si vous ne les voulez pas, supprimez les simplement :

Exemple 2. Liste tous les fichiers du dossier courant, sauf "." et ".."

<?php
if ($handle = opendir('.')) {
    while (
false !== ($file = readdir($handle))) {
        if (
$file != "." && $file != "..") {
            echo
"$file\n";
        }
    }
    
closedir($handle);
}
?>

Voir aussi is_dir() et glob().