Retourne une instance de la classe Directory

Description

dir(string $directory, ?resource $context = null): Directory|false

Un mécanisme pseudo-objet permet la lecture d'un dossier. L'argument directory est ouvert.

Liste de paramètres

directory: Le dossier à ouvrir
context: Note: Une resource de contexte de flux.

Valeurs de retour

Retourne une instance de la classe Directory en cas de succès, ou false en cas d'erreur.

Historique

Version	Description
8.0.0	`context` is now nullable.

Exemples

Exemple #1 Exemple avec dir()

Notez la façon dont la valeur de retour de Directory::read() 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.


<?php
$d = dir("/etc/php5");
echo "Pointeur : " . $d->handle . "\n";
echo "Chemin : " . $d->path . "\n";
while (false !== ($entry = $d->read())) {
   echo $entry."\n";
}
$d->close();
?>

Résultat de l'exemple ci-dessus est similaire à :

Pointeur : Resource id #2
Chemin : /etc/php5
.
..
apache
cgi
cli

Notes

Note:
L'ordre dans lequel les entrées du dossier sont retournées avec la méthode read dépend de votre système.