Открывает дескриптор каталога

Описание

resource opendir ( string $path [, resource $context ] )

Открывает дескриптор каталога для последующего использования с функциями closedir(), readdir() и rewinddir().

Список параметров

path: Путь к открываемому каталогу
context: Для описания параметра context обратитесь к разделу "Потоки".

Возвращаемые значения

Возвращает дескриптор каталога (resource) в случае успеха или FALSE в случае ошибки.

Если path не существует или каталог, расположенный по указанному пути, не может быть открыт вследствие правовых ограничений или ошибок файловой системы, функция opendir() вернет значение FALSE и сгенерирует сообщение PHP об ошибке уровня E_WARNING. Вы можете запретить вывод сообщения об ошибке, предварив имя функции opendir() символом '@'.

Список изменений

Версия	Описание
5.0.0	`path` теперь поддерживает обертку ftp://.
4.3.0	Параметр `path` теперь может являться любым URL, поддерживающим передачу списка файлов, однако в PHP 4 поддерживается только обертка file://

Примеры

Пример #1 Пример использования функции opendir()


<?php
$dir = "/etc/php5/";

// Открыть известный каталог и начать считывать его содержимое
if (is_dir($dir)) {
    if ($dh = opendir($dir)) {
        while (($file = readdir($dh)) !== false) {
            echo "файл: $file : тип: " . filetype($dir . $file) . "\n";
        }
        closedir($dh);
    }
}
?>

Результатом выполнения данного примера будет что-то подобное:

файл: . : тип: dir
файл: .. : тип: dir
файл: apache : тип: dir
файл: cgi : тип: dir
файл: cli : тип: dir

Смотрите также

is_dir() - Определяет, является ли имя файла директорией
readdir() - Получает элемент каталога по его дескриптору
dir() - Возвращает экземпляр класса Directory