(PHP 4, PHP 5)
dir — Zwraca egzemplarz klasy Directory
Pseudoobiektowy mechanizm czytania katalogu. Podany katalog zostaje otwarty. Gdy katalog zostaje otwarty dostępne są dwie właściwości. Właściwość handle może zostać użyta z innymi funkcjami takimi jak: readdir(), rewinddir() oraz closedir(). Właściwość path określa ścieżke do aktualnie otwartego katalogu. Dostępne są również trzy metody: read, rewind oraz close.
Przykład #1 Przykład dir()
Sposób w jaki zwrócona przez dir::read() wartość powinna być sprawdzona, obrazuje poniższy przykład. Należy sprawdzić czy zwrócona wartość jest równa (jest tego samego typu - zobacz również Operatory Porównania) FALSE. W przeciwnym razie plik o nazwie FALSE znajdujący się w czytanym katalogu zatrzymałby pętle.
<?php
$d = dir("/etc/php5");
echo "Uchwyt: " . $d->handle . "\n";
echo "Ścieżka: " . $d->path . "\n";
while (false !== ($entry = $d->read())) {
echo $entry."\n";
}
$d->close();
?>
Powyższy przykład wyświetli coś podobnego do:
Uchwyt: Resource id #2 Ścieżka: /etc/php5 . .. apache cgi cli
Informacja:
Kolejność w jakiej zostają zwrócone kolejne pliki czytanego katalogu, podczas korzystania z metody read jest zależna od systemu plików.