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 653. 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 654. 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 O, Liste des protocoles supportés pour une liste des protocoles URL supportés.

Voir aussi

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