FilesystemIterator::__construct

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

FilesystemIterator::__constructConstructs a new filesystem iterator

Description

public FilesystemIterator::__construct(string $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_DOTS is always set, and cannot be removed.

Return Values

No value is returned.

Errors/Exceptions

Throws an UnexpectedValueException if the directory cannot be found.

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