FilesystemIterator::__construct
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
FilesystemIterator::__construct — Constructs a new filesystem iterator
说明
$directory, int $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS)
Constructs a new filesystem iterator from the directory.
参数
-
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()
错误／异常
Throws an UnexpectedValueException
if the directory does not exist.
Throws a ValueError
if the directory is an empty string.
更新日志
| 版本 | 说明 |
|---|---|
| 8.2.0 |
Prior to PHP 8.2.0, FilesystemIterator::SKIP_DOTS was
always set and could not be removed.
|
| 8.0.0 |
Now throws a ValueError if
directory is an empty string;
previously it threw a RuntimeException.
|
示例
示例 #1 FilesystemIterator::__construct() example
<?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
Output of the above example prior to PHP 8.2.0 is similar to:
apples.jpg banana.jpg example.php
参见
- FilesystemIterator::setFlags() - Sets handling flags
- DirectoryIterator::__construct() - Constructs a new directory iterator from a path
add a note
