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