Compzone.Org :: Podręcznik PHP :: dir

Podręcznik PHP
Poprzedni		Następny

dir

(PHP 3, PHP 4, PHP 5)

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.

Przykłady

Przykład 1. dir() przykład

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.

<?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

Notatki

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