Forum und email

opendir

(PHP 4, PHP 5)

opendir — Ö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

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