dir

(PHP 4, PHP 5, PHP 7)

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

Описание

dir ( string $directory [, resource $context ] ) : Directory

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

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

directory

Каталог для открытия

context

Замечание: Поддержка контекста была добавлена в PHP 5.0.0. Для описания контекстов смотрите раздел Потоки.

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

Возвращает экземпляр класса Directory, NULL при неверных параметрах, и FALSE в случае другой ошибки.

Примеры

Пример #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" возвращает элементы каталога, зависит от операционной системы.