Katalogi
PHP Manual

readdir

(PHP 4, PHP 5)

readdirCzyta 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.

Ostrzeżenie

Ta funkcja może zwrócić logiczne FALSE, ale także zwykłą wartość rozpoznawaną jako FALSE, na przykład 0 lub "". Więcej informacji w rozdziale dotyczącym typów logicznych. Użyj operatora === aby sprawdzić wartość zwracaną przez tę funkcję.

Przykłady

Example #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); 
}
?>

Example #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


Katalogi
PHP Manual