dir

PHP Handbuch
Zurück		Weiter

Beschreibung

class dir {

dir ( string directory )

string path

resource handle

string read ( void )

void rewind ( void )

void close ( void )

}

Ein pseudo-objektorientierter Mechanismus zum Lesen eines Verzeichnisses. Das in directory angegebene Verzeichnis wird geöffnet. Sobald das Verzeichnis geöffnet ist, stehen 2 Eigenschaften zur Verfügung. Die Eigenschaft Handle kann mit anderen Verzeichnis-Funktionen wie readdir(), rewinddir() und closedir() benutzt werden. Die Eigenschaft Path enthält die Pfadangabe des geöffneten Verzeichnisses. Es sind 3 Methoden verfügbar: read (lesen), rewind (zurücksetzen) und close (schließen).

Beispiele

Beispiel 1. dir() Beispiel
Beachten Sie im nachfolgenden Beispiel, wie der Rückgabewert der Funktion dir() überprüft wird. Es wird explizit getestet, ob der Rückgabewert identisch (den gleichen Wert und Datentyp hat, siehe Vergleichs-0peratoren) mit FALSE ist, weil sonst jeder Verzeichniseintrag, der zu FALSE ausgewertet wird, die Schleife abbricht.
<?php $d = dir("/etc/php5"); echo "Handle: " . $d->handle . "\n"; echo "Path: " . $d->path . "\n"; while (false !== ($entry = $d->read())) { echo $entry."\n"; } $d->close(); ?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Handle: Resource id #2 Path: /etc/php5 . .. apache cgi cli

Anmerkungen

Anmerkung: Die Reihenfolge der Verzeichniseinträge, die von der read-Methode zurückgegeben werden, ist systemabhängig.

Anmerkung: Hierdurch wird die interne Klasse Directory definiert, was bedeutet, dass Sie keine eigenen Klassen mit diesem Namen definieren können. Eine vollständige Liste der vordefinierten Klassen in PHP finden Sie unter Vordefinierte Klassen.