rewinddir
Fileinfo
Verzeichnis-Funktionen
PHP Manual

# scandir

(PHP 5)

scandir — Listet Dateien und Verzeichnisse innerhalb eines angegebenen Pfades auf

### Beschreibung

array scandir ( string `$directory` [, int `$sorting_order`= 0 [, resource `$context` ]] )

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

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

Tipp

Mit dieser Funktion können Sie eine URL als Dateinamen verwenden, falls Sie fopen wrappers ermöglicht haben. Mehr Details dazu, wie Sie den Dateinamen angeben müssen finden Sie bei fopen(). Eine Liste der unterstützten URL Protokolle finden Sie unter List of Supported Protocols/Wrappers.

### Siehe auch

- opendir() - Öffnen eines Verzeichnis-Handles
- readdir() - Liest einen Eintrag aus einem Verzeichnis-Handle
- glob() - Findet Dateinamen, die mit einem Muster übereinstimmen
- is_dir() - Prüft, ob der gegebene Dateiname ein Verzeichnis ist
- sort() - Sortiert ein Array

rewinddir
Fileinfo
Verzeichnis-Funktionen
PHP Manual