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
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
