Funkcje katalogów
PHP Manual

dir

(PHP 4, PHP 5)

dirZwraca egzemplarz klasy Directory

Opis

Directory
Directory {
string $path ;
resource $handle ;
string read ( void )
void rewind ( void )
void close ( void )
}

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łady

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

Notatki

Informacja: Kolejność w jakiej zostają zwrócone kolejne pliki czytanego katalogu, podczas korzystania z metody read jest zależna od systemu plików.


Funkcje katalogów
PHP Manual