array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.opendir.php', 1 => 'opendir', 2 => 'Öffnet ein Verzeichnis-Handle', ), 'up' => array ( 0 => 'ref.dir.php', 1 => 'Verzeichnis-Funktionen', ), 'prev' => array ( 0 => 'function.getcwd.php', 1 => 'getcwd', ), 'next' => array ( 0 => 'function.readdir.php', 1 => 'readdir', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/dir/functions/opendir.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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

Siehe auch