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` стал обнуляемым.

Примеры

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