Manuel PHP
Précédent |  | Suivant

# scandir

(PHP 5)

scandir -- Liste les fichiers et dossiers dans un dossier

## Description

array scandir ( string directory [, int sorting_order [, resource context]] )

Retourne un tableau de fichier et dossier, issus de directory.

## Liste de paramètres

directory

  Le dossier qui sera scanné.

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. Alternatives à 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 l'option des "fopen wrappers" a été activée. Voyez fopen() pour plus de détails sur la façon de spécifier le nom du fichier et Annexe M pour une liste des protocoles URL supportés.

## Voir aussi

opendir()
readdir()
glob()
is_dir()
sort()

Précédent | Sommaire | Suivant
rewinddir | Niveau supérieur | Fonctions DOM