php-resource

PHP 5.4.x Handbuch


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

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() - Prüft, ob der angegebene Dateiname ein Verzeichnis ist
  • readdir() - Liest einen Eintrag aus einem Verzeichnis-Handle
  • dir() - Gibt eine Instanz der Directory Klasse zurück




Anmerkungen zum PHP Handbuch
Neue Anmerkung schreiben