(PHP 5, PHP 7, PHP 8)
scandir — Listet Dateien und Verzeichnisse innerhalb eines angegebenen Pfades auf
$directory, int$sorting_order = SCANDIR_SORT_ASCENDING, ?resource$context = null): array|false Gibt ein Array aus Dateien und Verzeichnissen des aktuellen directory zurück.
directoryDas zu untersuchende Verzeichnis.
sorting_order Standardmäßig ist die Sortierreihenfolge alphabetisch in aufsteigender Reihenfolge. Wenn der optionale Parameter sorting_order auf SCANDIR_SORT_DESCENDING gesetzt wird, ist die Sortierreihenfolge alphabetisch absteigend. Wenn er auf SCANDIR_SORT_NONE gesetzt wird, ist das Ergebnis unsortiert.
context Für eine Beschreibung des Parameters context siehe das Kapitel über Streams im Handbuch.
Gibt bei Erfolg ein Array von Dateinamen zurück oder im Fehlerfall false. Wenn directory kein Verzeichnis ist, wird der boolsche Wert false zurückgegeben und ein Fehler vom Typ E_WARNING erzeugt.
| Version | Beschreibung |
|---|---|
| 8.0.0 | context ist nun nullable (akzeptiert den null-Wert). |
Beispiel #1 Ein einfaches scandir()-Beispiel
<?php
$dir = '/tmp';
$files1 = scandir($dir);
$files2 = scandir($dir, SCANDIR_SORT_DESCENDING);
print_r($files1);
print_r($files2);
?>Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Array ( [0] => . [1] => .. [2] => bar.php [3] => foo.txt [4] => somedir ) Array ( [0] => somedir [1] => foo.txt [2] => bar.php [3] => .. [4] => . )
Wenn fopen wrappers aktiviert ist, kann mit dieser Funktion eine URL als Dateiname verwendet werden. Mehr Details dazu, wie der Dateiname angeben werden muss, sind bei fopen() zu finden. Eine Liste der unterstützten URL-Protokolle, die Fähigkeiten der verschiedenen Wrapper, Hinweise zu deren Verwendung und Informationen zu den eventuell vorhandenen vordefinierten Variablen sind unter Unterstützte Protokolle und Wrapper zu finden.