(PHP 4, PHP 5, PHP 7)
dir — Возвращает экземпляр класса 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" возвращает элементы каталога, зависит от операционной системы.