Fonctions sur les dossiers
PHP Manual

readdir

(PHP 4, PHP 5)

readdirLit 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 l'ordre dans lequel ils sont enregistrés dans le système de fichiers.

Liste de paramètres

dir_handle

La ressource de dossier ouverte précédemment avec opendir(). Si la ressource de dossier n'est pas spécifiée, la dernière ressource ouverte avec la fonction opendir() sera utilisée.

Valeurs de retour

Retourne le nom du fichier en cas de réussite ou FALSE si une erreur survient.

Avertissement

Cette fonction peut retourner FALSE, mais elle peut aussi retourner une valeur équivalent à FALSE comme 0 ou "". 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.

Exemples

Exemple #1 Liste de tous les fichiers dans le répertoire

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 
"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);
}
?>

Exemple #2 Liste de tous les fichiers dans le répertoire courant et enlève les . et ..

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

Voir aussi


Fonctions sur les dossiers
PHP Manual