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


(PHP 4, PHP 5)

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

Описание

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