(PHP 5, PHP 7, PHP 8)
scandir —
Liste les fichiers et dossiers dans un dossier
Description
scandir(string
$directory
, int
$sorting_order
=
SCANDIR_SORT_ASCENDING
, ?resource
$context
=
null
): array|false
Liste de paramètres
-
directory
-
Le 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.
Valeurs de retour
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.
Historique
Exemples
Exemple #1 Un simple exemple avec scandir()
<?php
$dir = '/tmp';
$files1 = scandir($dir);
$files2 = scandir($dir, SCANDIR_SORT_DESCENDING);
print_r($files1);
print_r($files2);
?>
Résultat de l'exemple ci-dessus est similaire à :
Array
(
[0] => .
[1] => ..
[2] => bar.php
[3] => foo.txt
[4] => somedir
)
Array
(
[0] => somedir
[1] => foo.txt
[2] => bar.php
[3] => ..
[4] => .
)
Notes
Astuce
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 les variables prédéfinies qu'elles fournissent.
Voir aussi
- opendir() - Ouvre un dossier, et récupère un pointeur dessus
- readdir() - Lit une entrée du dossier
- glob() - Recherche des chemins qui vérifient un masque
- is_dir() - Indique si le fichier est un dossier
- sort() - Trie un tableau en ordre croissant