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` = 0 [, 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. Si le paramètre optionnel `sorting_order` est utilisé (mis à 1), alors le tri sera en ordre alphabétique inverse.

`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.

### 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ée. Voyez fopen() pour plus de détails sur la façon de spécifier le nom du fichier. Repportez-vous aux Liste des protocoles 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