PHP Dokumentation: Function scandir
12. Januar 2010 von werner
scandir
(PHP 5)
scandir — Listet Dateien und Verzeichnisse innerhalb eines angegebenen Pfades auf
Beschreibung
Gibt ein Array aus Dateien und Verzeichnissen des aktuellen directory wieder.
Parameter-Liste
- directory
Das zu untersuchende Verzeichnis.
- sorting_order
Standardmäßig ist die Sortierreihenfolge alphabetisch in aufsteigender Reihenfolge. Wenn der optionale Parameter sorting_order auf einen Wert verschieden von null gesetzt wird, ist die Sortierreihenfolge alphabetisch absteigend.
- context
Für die Beschreibung des context-Parameters konsultieren Sie bitte das Kapitel Streams des Manuals.
Rückgabewerte
Gibt bei Erfolg ein Array von Dateinamen zurück, im Fehlerfall FALSE. Wenn directory kein Verzeichnis ist, wird der boolsche Wert FALSE zurück gegeben und ein Fehler vom Type E_WARNING erzeugt.
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 erzeugteine ä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] => .)
Beispiel #2 PHP 4-Alternativen zu scandir()
<?php
$dir = "/tmp";
$dh = opendir($dir);
while (false !== ($filename = readdir($dh))) {
$files[] = $filename;
}sort($files);print_r($files);rsort($files);print_r($files);?>Das oben gezeigte Beispiel erzeugteine ä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
Mit dieser Funktion können Sie eineURL als Dateinamen verwenden, falls Sie fopen wrappers ermöglicht haben. Mehr Details dazu, wie Sie denDateinamen angeben müssen finden Sie bei fopen(). EineListe der unterstützten URL Protokolle finden Sie unterList of Supported Protocols/Wrappers.