dir

    (PHP 4, PHP 5, PHP 7, PHP 8)

    dir — Liefert eine Instanz der Directory-Klasse

    Beschreibung

    dir(string$directory, ?resource$context = null): Directory|false

    Ein pseudo-objektorientierter Mechanismus zum Lesen eines Verzeichnisses. Das in directory angegebene Verzeichnis wird geöffnet.

    Parameter-Liste

    directory

    Das zu öffnende Verzeichnis.

    context

    Eine Stream-Kontext-Ressource.

    Rückgabewerte

    Gibt eine Instanz der Directory-Klasse zurück oder false im Falle eines Fehlers.

    Changelog

    VersionBeschreibung
    8.0.0context ist nun nullable (akzeptiert den null-Wert).

    Beispiele

    Beispiel #1 dir()-Beispiel

    Beachten Sie im nachfolgenden Beispiel, wie der Rückgabewert der Funktion Directory::read() überprüft wird. Es wird explizit getestet, ob der Rückgabewert identisch (den gleichen Wert und Datentyp hat, siehe Vergleichs-0peratoren) mit false ist, weil sonst jeder Verzeichniseintrag, der zu false ausgewertet wird, die Schleife abbricht.

    <?php
    $d     = dir("/etc/php5");
    echo     "Handle: " . $d->handle . "\n";
    echo     "Pfad: " . $d->path . "\n";
    while (    false !== ($entry = $d->read())) {
    echo     $entry."\n";
    }
    $d->close();
    ?>

    Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    Handle: Resource id #2 Pfad: /etc/php5 . .. apache cgi cli

    Anmerkungen

    Hinweis:

    Die Reihenfolge der Verzeichniseinträge, die von der read-Methode zurückgegeben werden, ist systemabhängig.

    To Top