PHP Handbuch
Zurück |  | Weiter

# dir

dir -- Verzeichnis-Klasse

## Beschreibung:

class dir {
dir ( string directory )
string path
resource handle
string read ( void )
void rewind ( void )
void close ( void )
}

Ein Pseudo-Objekt-Orientierter Mechanismus zum Lesen eines Verzeichnisses. Das per 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 (Handles sind Verweise auf Einträge in einer internen Tabelle zur Verwaltung von Objekten). Die Eigenschaft Path enthält die Pfadangabe des geöffneten Verzeichnisses. Es sind 3 Methoden verfügbar: read, rewind und close.

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.

Beispiel 1. dir()-Beispiel:
`<?php $d = dir("/etc"); echo "Handle: " . $d->handle . "<br />\n"; echo "Path: " . $d->path . "<br />\n"; while (false !== ($entry = $d->read())) { echo $entry."<br />\n"; } $d->close(); ?>`

> 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 gibt es unter Vordefinierte Klassen.

Zurück | Zum Anfang | Weiter
chroot | Nach oben | closedir