PHP Handbuch
Zurück |  | Weiter

# scandir

(PHP 5)

scandir -- Listet Dateien und Verzeichnisse innerhalb eines angegebenen Pfades auf

## Beschreibung

array scandir ( string directory [, int sorting_order [, 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 verwendet wird (auf 1 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 Anhang M.

## Siehe auch

opendir()
readdir()
glob()
is_dir()
sort()

Zurück | Zum Anfang | Weiter
rewinddir | Nach oben | DOM Functions