FilesystemIterator::__construct
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
FilesystemIterator::__construct — Constructs a new filesystem iterator
Description
$directory,
int $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS)
Constructs a new filesystem iterator from the directory.
Parameters
-
directory -
The path of the filesystem item to be iterated over.
-
flags -
Flags may be provided which will affect the behavior of some methods. A list of the flags can found under FilesystemIterator predefined constants. They can also be set later with FilesystemIterator::setFlags()
Note:
FilesystemIterator::SKIP_DOTSis always set, and cannot be removed.
Errors/Exceptions
Throws an UnexpectedValueException if the directory does not exist.
Throws a ValueError if the directory is an empty string.
Changelog
| Version | Description |
|---|---|
| 8.0.0 | Now throws a ValueError if directory is an empty string; previously it threw a RuntimeException. |
Examples
Example #1 FilesystemIterator::__construct() example
<?php
$it = new FilesystemIterator(dirname(__FILE__));
foreach ($it as $fileinfo) {
echo $fileinfo->getFilename() . "\n";
}
?>
The above example will output:
apples.jpg banana.jpg example.php
See Also
- FilesystemIterator::setFlags() - Sets handling flags
- DirectoryIterator::__construct() - Constructs a new directory iterator from a path
© 1997–2021 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/filesystemiterator.construct.php
