Podręcznik PHP
PoprzedniNastępny

readdir

(PHP 3, PHP 4, PHP 5)

readdir -- Czyta zawartość katalogu

Opis

string readdir ( resource uchwyt_katalogu )

Zwraca nazwy plików w katalogu, w kolejności podanej przez system plików.

Parametry

uchwyt_katalogu

Uchwyt katalogu typu zasób uprzednio otworzony przez opendir().

Zwracane wartości

Zwraca nazwę pliku w przypadku sukcesu, lub FALSE porażki.

Przykłady

Przykład 1. Lista wszystkich plików w katalogu

Sposób w jaki zwrócona przez readdir() 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
//  !== nie istniał w wersji wcześniejszej niż 4.0.0-RC2

if ($handle = opendir('/path/to/files')) {
    echo "Directory handle: $handle\n";
    echo "Files:\n";

    /* To jest poprawna metoda  */
    while (false !== ($file = readdir($handle))) {
        echo "$file\n";
    }

    /* To jest ZŁA metoda */
    while ($file = readdir($handle)) {
        echo "$file\n";
    }

    closedir($handle);
}
?>

Przykład 2. Lista wszystkich plików w wskazanym katalogu oprócz . i ..

<?php
if ($handle = opendir('.')) {
    while (false !== ($file = readdir($handle))) {
        if ($file != "." && $file != "..") {
            echo "$file\n";
        }
    }
    closedir($handle);
}
?>

Patrz także

is_dir()
glob()

PoprzedniSpis treściNastępny
opendirPoczątek rozdziałurewinddir