dir

(PHP 4, PHP 5, PHP 7)

dirRetourne une instance de la classe Directory

Description

dir ( string $directory [, resource $context ] ) : Directory

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: Le support de contexte a été ajouté en PHP 5.0.0. Pour une description des contexts, référez-vous à Flux.

Valeurs de retour

Retourne une instance de la classe Directory en cas de succès, NULL si de mauvais arguments sont passés, ou FALSE pour les autres types d'erreur.

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();
?>

L'exemple ci-dessus va afficher quelque chose de 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.