FilesystemIterator::__construct
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
FilesystemIterator::__construct — Создаёт новый итератор файловой системы
Описание
$directory, int $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS)
Создаёт новый объект итератора файловой системы на основе аргумента
directory.
Список параметров
-
directory -
Путь к объекту файловой системы по которому требуется навигация.
-
flags -
Поведение некоторых методов можно задать с помощью флагов. Список этих флагов можно найти на странице предопределённых констант FilesystemIterator. Также их можно задать позже методом FilesystemIterator::setFlags().
Ошибки
Выбрасывает исключение UnexpectedValueException,
если директория directory не существует.
Выбрасывает исключение ValueError,
если параметр directory содержит пустую строку.
Список изменений
| Версия | Описание |
|---|---|
| 8.2.0 |
До версии PHP 8.2.0, константа FilesystemIterator::SKIP_DOTS
всегда была установлена и не могла быть удалена.
|
| 8.0.0 |
Теперь выбрасывает исключение ValueError,
если параметр directory содержит пустую строку;
ранее выбрасывалось исключение RuntimeException.
|
Примеры
Пример #1 Пример использования FilesystemIterator::__construct()
<?php
$it = new FilesystemIterator(dirname(__FILE__), FilesystemIterator::CURRENT_AS_FILEINFO);
foreach ($it as $fileinfo) {
echo $fileinfo->getFilename() . "\n";
}
?>Результат выполнения приведённого примера в PHP 8.2 аналогичен:
. .. apples.jpg banana.jpg example.php
Вывод приведённого выше примера до версии PHP 8.2.0 выглядит следующим образом:
apples.jpg banana.jpg example.php
Смотрите также
- FilesystemIterator::setFlags() - Задание флагов обработки
- DirectoryIterator::__construct() - Создаёт новый итератор каталогов из пути
add a note
