Podręcznik PHP
Poprzedni |  | Następny

# dir

dir -- Klasa obsługi katalogów

## Opis

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

Pseudo obiektowo zorientowany 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.

Sposób w jaki zwrócona przez dir() 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ż Comparison Operators) `FALSE`. W przeciwnym razie plik o nazwie `FALSE` (jak również "0") znajdujący się w czytanym katalogu zatrzymał by pętle.

Przykład 1. Przykład użycia dir()
`<?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(); ?>`
Powyższy przykład wyświetli coś podobnego do:
    Handle: Resource id #2
    Path: /etc/php5
    .
    ..
    apache
    cgi
    cli

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

> Notatka: dir definiuje wewnętrzną klase Directory, co oznacza że nie można samemu zdefiniować klasy o tej nazwie. Zobacz również lista wszystkich predefiniowanych klas w PHP Predefined Classes.

Poprzedni | Spis treści | Następny
chroot | Początek rozdziału | closedir