rewinddir
Fileinfo
Fonctions sur les dossiers
PHP Manual

# scandir

(PHP 5)

scandir — Liste les fichiers et dossiers dans un dossier

### Description

array scandir ( string `$directory` [, int `$sorting_order` = SCANDIR_SORT_ASCENDING [, resource `$context` ]] )

Retourne un tableau de fichier et dossier, 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`, 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

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.

### Exemples

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] => .
    )

### 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 leurs variables prédéfinies fournies.

### 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

rewinddir
Fileinfo
Fonctions sur les dossiers
PHP Manual