PHP-Handbuch: Öffnen eines Verzeichnis-Handles

Beschreibung

resource opendir ( string $path [, resource $context ] )

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

Parameter-Liste

path: Der zu öffnende Verzeichnis-Pfad.
context: Für die Beschreibung des context-Parameters konsultieren Sie bitte das Kapitel Streams des Manuals.

Rückgabewerte

Gibt bei Erfolg ein Verzeichnis-handle resource zurück, im Fehlerfalle FALSE.

Wenn path kein valides Verzeichnis ist oder das Verzeichnis auf Grund von Zugriffsbeschränkungen oder Filesystem-Problemen nicht geöffnet werden kann, gibt opendir FALSE zurück und generiert einen PHP-Fehler des Typs E_WARNING. Sie können die Ausgabe der Fehlermeldung von opendir unterdrücken, indem Sie ein '@' vor dem Funktionsnamen notieren.

Changelog

Version	Beschreibung
5.0.0	`path` unterstützt den ftp:// URL-Wrapper.
4.3.0	`path` kann auch eine URL sein, die Directory-Listing unterstützt, allerdings wird nur der file:// URL-Wrapper von PHP 4 unterstützt.

Beispiele

Beispiel #1 opendir Beispiel


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

// Öffnen eines bekannten Verzeichnisses und danach seinen Inhalt einlesen
if (is_dir($dir)) {
    if ($dh = opendir($dir)) {
        while (($file = readdir($dh)) !== false) {
            echo "filename: $file : filetype: " . filetype($dir . $file) . "\n";
        }
        closedir($dh);
    }
}
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

filename: . : filetype: dir
filename: .. : filetype: dir
filename: apache : filetype: dir
filename: cgi : filetype: dir
filename: cli : filetype: dir

Siehe auch

is_dir
readdir
dir