opendir

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

    opendir — Öffnet ein Verzeichnis-Handle

    Beschreibung

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

    Öffnet ein Verzeichnis-Handle zur Verwendung in nachfolgenden Aufrufen von closedir(), readdir() und rewinddir().

    Parameter-Liste

    directory

    Der zu öffnende Verzeichnis-Pfad.

    context

    Für eine Beschreibung des Parameters context siehe das Kapitel über Streams im Handbuch.

    Rückgabewerte

    Gibt bei Erfolg eine Verzeichnis-Handle-Ressource zurück. Bei einem Fehler wird false zurückgegeben.

    Fehler/Exceptions

    Im Fehlerfall wird eine E_WARNING ausgegeben.

    Dies kann passieren, wenn directory kein valides Verzeichnis ist oder das Verzeichnis auf Grund von Zugriffsbeschränkungen oder Dateisystem-Problemen nicht geöffnet werden kann.

    Changelog

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

    Beispiele

    Beispiel #1 opendir()-Beispiel

    <?php
    $dir     = "/etc/php5/";

    // Ein bekanntes Verzeichnis öffnen und danach seinen Inhalt einlesen
    if (is_dir($dir)) {
    if (    $dh = opendir($dir)) {
    while ((    $file = readdir($dh)) !== false) {
    echo     "Dateiname: $file : Dateityp: " . filetype($dir . $file) . "\n";
    }
    closedir($dh);
    }
    }
    ?>

    Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    Dateiname: . : Dateityp: dir Dateiname: .. : Dateityp: dir Dateiname: apache : Dateityp: dir Dateiname: cgi : Dateityp: dir Dateiname: cli : Dateityp: dir

    Siehe auch

    • is_dir() - Prüft, ob der angegebene Dateiname ein Verzeichnis ist
    • readdir() - Liest einen Eintrag aus einem Verzeichnis-Handle
    • dir() - Liefert eine Instanz der Directory-Klasse
    To Top