opendir

(PHP 4, PHP 5, PHP 7, PHP 8)

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

Описание

opendir(string $directory, ?resource $context = null): resource|false

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

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

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

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

Возвращает дескриптор каталога (resource) в случае успешного выполнения или false, если возникла ошибка.

Ошибки

В случае неудачного завершения работы генерируется ошибка уровня E_WARNING.

Может произойти, если directory не является директорией, директория не может быть открыта из-за недостаточных разрешений или из-за ошибок файловой системы.

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

Версия	Описание
8.0.0	`context` теперь допускает значение null.

Примеры

Пример #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