array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.scandir.php', 1 => 'scandir', 2 => 'Liste les fichiers et dossiers dans un dossier', ), 'up' => array ( 0 => 'ref.dir.php', 1 => 'Fonctions sur les dossiers', ), 'prev' => array ( 0 => 'function.rewinddir.php', 1 => 'rewinddir', ), 'next' => array ( 0 => 'book.fileinfo.php', 1 => 'Fileinfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/dir/functions/scandir.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

scandir

(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

Retourne un tableau de fichiers et de dossiers issus de directory.

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, se reporter à 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

Version Description
8.0.0 context est désormais nullable.

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