(PHP 4, PHP 5, PHP 7, PHP 8)
readdir — Lit une entrée du dossier
Description
readdir(?resource
$dir_handle
=
null
): string|false
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 de l'entrée 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
.
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.
Historique
Exemples
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);
}
?>
Voir aussi
- is_dir() - Indique si le fichier est un dossier
- glob() - Recherche des chemins qui vérifient un masque
- opendir() - Ouvre un dossier, et récupère un pointeur dessus
- scandir() - Liste les fichiers et dossiers dans un dossier