opendir
(PHP 4, PHP 5, PHP 7, PHP 8)
opendir — Öffnet ein Verzeichnis-Handle
Beschreibung
$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
contextsiehe 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
| Version | Beschreibung |
|---|---|
| 8.0.0 |
context 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
