Index of /php_manual_ru2/f/readdir.htm

readdir

(PHP 3, PHP 4)

readdir - читает вхождение из дескриптора директории.

Описание

string readdir (resource dir_handle)

Возвращает filename следующего файла из данной директории. Имена файлов возвращаются в порядке, в котором они хранятся в файловой системе.

Обратите внимание на способ, которым return -значение функции readdir() проверяется в следующем примере. Мы явным образом проверяем, идентично ли return-значение (равно и того же типа, что и  --  см. Операции сравнения) FALSE, поскольку иначе любое вхождение директории, имя которого вычисляется в FALSE, остановит цикл.

// Обратите внимание, что !== не существовала до 4.0.0-RC2
<?php
if ($handle = opendir('/path/to/files')) {
    echo "Directory handle: $handle\n";
    echo "Files:\n";

    /* Это корректный способ цикла по директории. */
    while (false !== ($file = readdir($handle))) { 
        echo "$file\n";
    }

    /* Это НЕПРАВИЛЬНЫЙ способ цикла по директории. */
    while ($file = readdir($handle)) { 
        echo "$file\n";
    }

    closedir($handle);
}
?>

Заметьте, что readdir() возвратит вхождения . и ... Если это нежелательно, просто вырежьте их:

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

См. также is_dir().