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**зупинить цикл.
Висновок наведеного прикладу буде схожим на:
Дескриптор: Resource id #2
Путь: /etc/php5
.
..
apache
cgi
cli
Примітки
Зауваження :
Порядок, у якому метод "read" повертає елементи каталогу, залежить від операційної системи.