scandir

Table des matières

(PHP 5, PHP 7)

scandir — Liste les fichiers et dossiers dans un dossier

Description

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

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

Retour à la première page de Manuel PHP Table des matières Haut

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.

Retour à la première page de Manuel PHP Table des matières Haut

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.

Retour à la première page de Manuel PHP Table des matières Haut

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.

Retour à la première page de Manuel PHP Table des matières Haut

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

Retour à la première page de Manuel PHP Table des matières Haut

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.

Retour à la première page de Manuel PHP Table des matières Haut

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

Rechercher une fonction PHP

Version en cache

23/12/2024 07:29:34 Cette version de la page est en cache (à la date du 23/12/2024 07:29:34) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.scandir.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut