(PHP 5, PHP 7)
scandir — Liste les fichiers et dossiers dans un dossier
$directory
[, int $sorting_order = SCANDIR_SORT_ASCENDING
[, resource $context
]] )
Retourne un tableau de fichier
et dossier, issus de directory.
directoryLe dossier qui sera analysé.
sorting_order
Par défaut, le tri est en ordre alphabétique, croissant. Si le
paramètre optionnel sorting_order
est défini à SCANDIR_SORT_DESCENDING,
alors le tri sera en ordre alphabétique inverse.
Si ce paramètre est défini à SCANDIR_SORT_NONE,
alors le résultat ne sera pas trié.
context
Pour une description du paramètre context,
référez-vous à la section flux de
données du manuel.
Retourne un tableau des fichiers en cas de succès ou FALSE en cas
d'échec. Si directory n'est pas un dossier, alors
une valeur booléenne FALSE est retournée et une erreur de niveau
E_WARNING est générée.
| Version | Description |
|---|---|
| 5.4.0 |
La constante sorting_order
a été ajoutée. Toute valeur différente de zéro provoquera un ordre
décroissant dans les anciennes versions. Aussi, pour toutes
les versions de PHP, utilisez 0 pour un ordre
croissant, et 1 pour un ordre décroissant.
L'option pour le comportement de SCANDIR_SORT_NONE
n'existe pas avant la version 5.4.0 de PHP.
|
Exemple #1 Un simple exemple avec scandir()
<?php
$dir = '/tmp';
$files1 = scandir($dir);
$files2 = scandir($dir, 1);
print_r($files1);
print_r($files2);
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Array
(
[0] => .
[1] => ..
[2] => bar.php
[3] => foo.txt
[4] => somedir
)
Array
(
[0] => somedir
[1] => foo.txt
[2] => bar.php
[3] => ..
[4] => .
)
Exemple #2 Remplacement à scandir() pour PHP 4
<?php
$dir = "/tmp";
$dh = opendir($dir);
while (false !== ($filename = readdir($dh))) {
$files[] = $filename;
}
sort($files);
print_r($files);
rsort($files);
print_r($files);
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Array
(
[0] => .
[1] => ..
[2] => bar.php
[3] => foo.txt
[4] => somedir
)
Array
(
[0] => somedir
[1] => foo.txt
[2] => bar.php
[3] => ..
[4] => .
)
Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a été activé. Voyez fopen() pour plus de détails sur la façon de spécifier le nom du fichier. Reportez-vous aux Liste des protocoles et des gestionnaires supportés pour plus d'informations sur les capacités des différents gestionnaires, les notes sur leur utilisation, ainsi que les informations sur leurs variables prédéfinies fournies.