scandir
(PHP 5, PHP 7, PHP 8)
scandir — Listet Dateien und Verzeichnisse innerhalb eines angegebenen Pfades auf
Beschreibung
$directory, int $sorting_order = SCANDIR_SORT_ASCENDING, ?resource $context = null): array|false
Gibt ein Array aus Dateien und Verzeichnissen des aktuellen
directory zurück.
Parameter-Liste
-
directory -
Das zu untersuchende Verzeichnis.
-
sorting_order -
Standardmäßig ist die Sortierreihenfolge alphabetisch in aufsteigender Reihenfolge. Wenn der optionale Parameter
sorting_orderaufSCANDIR_SORT_DESCENDINGgesetzt wird, ist die Sortierreihenfolge alphabetisch absteigend. Wenn er aufSCANDIR_SORT_NONEgesetzt wird, ist das Ergebnis unsortiert. -
context -
Für eine Beschreibung des Parameters
contextsiehe das Kapitel über Streams im Handbuch.
Rückgabewerte
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.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
context ist nun nullable (akzeptiert den
null-Wert).
|
Beispiele
Beispiel #1 Ein einfaches scandir()-Beispiel
<?php
$dir = '/tmp';
$files1 = scandir($dir);
$files2 = scandir($dir, 1);
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] => .
)
Anmerkungen
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.
Siehe auch
