Funktion opendir

Die Funktion opendir öffnet das angegebene Verzeichnis und gibt seinen Handle (Ressource) zurück, der dann mit Funktionen zum Lesen des Verzeichnisinhalts verwendet wird. Nach Beendigung der Arbeit mit dem Verzeichnis muss es mit closedir geschlossen werden.

Syntax

phpopendir(string $path, resource $context = null): resource|false

Beispiel

Grundlegende Verwendung von opendir:

php<?php
  $dir = opendir('/path/to/directory');
  
  if ($dir) {
    while (($file = readdir($dir)) !== false) {
      echo $file . "\n";
    }
    closedir($dir);
  }
?>

Ergebnis der Codeausführung (Beispielausgabe):

php"."
".."
"file1.txt"
"subdirectory"

Beispiel

Fehlerbehandlung beim Öffnen eines Verzeichnisses:

php<?php
  $dir = opendir('/nonexistent/path');
  if ($dir === false) {
    echo "Verzeichnis konnte nicht geöffnet werden";
  } else {
    // Arbeit mit dem Verzeichnis
    closedir($dir);
  }
?>

Ergebnis der Codeausführung:

php"Verzeichnis konnte nicht geöffnet werden"

Beispiel

Verwendung mit Stream-Kontext:

php<?php
  $context = stream_context_create();
  $dir = opendir('ftp://user:password@example.com/', $context);
  if ($dir) {
    // Lesen des Inhalts des FTP-Verzeichnisses
    closedir($dir);
  }
?>

In diesem Beispiel wird eine Verbindung zu einem FTP-Server geöffnet, um den Inhalt eines entfernten Verzeichnisses zu lesen.

Siehe auch

  • die Funktion readdir,
    die den Inhalt eines geöffneten Verzeichnisses liest
  • die Funktion closedir,
    die den Verzeichnis-Handle schließt
  • die Funktion scandir,
    die eine Liste von Dateien und Verzeichnissen als Array zurückgibt