Manuel PHP
Précédent |  | Suivant

# 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 l'ordre qu'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().

## Valeurs de retour

Retourne le nom du fichier en cas de réussite ou `FALSE` en cas d'échec.

## 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
// 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);
}
?>`

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

is_dir()
glob()

Précédent | Sommaire | Suivant
opendir | Niveau supérieur | rewinddir