dir

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

dir — Возвращает экземпляр класса Directory

Описание

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

Псевдо-объектно-ориентированный механизм для чтения каталога. Открывается переданный в параметре directory каталог.

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

directory: Каталог для открытия
context: Ресурс (resource) контекста потока.

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

Возвращает экземпляр класса Directory или false в случае возникновения ошибки.

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

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

Примеры

Пример #1 Пример использования dir()

Обратите внимание на способ, которым осуществляется проверка значения, возвращаемого Directory::read() в примере, приведённом ниже. В этом примере явно проводится проверка значения на идентичность (выражения идентичны, когда они равны и являются одного типа - за более подробной информацией обратитесь к главе Операторы сравнения) значению false, поскольку в ином случае, любой элемент каталога, чьё имя может быть выражено как false, остановит цикл.

<?php
$d = dir("/etc/php5");
echo "Дескриптор: " . $d->handle . "\n";
echo "Путь: " . $d->path . "\n";
while (false !== ($entry = $d->read())) {
   echo $entry."\n";
}
$d->close();
?>

Вывод приведённого примера будет похож на:

Дескриптор: Resource id #2
Путь: /etc/php5
.
..
apache
cgi
cli

Примечания

Замечание:
Порядок, в котором метод "read" возвращает элементы каталога, зависит от операционной системы.