DirectoryIterator::__construct

(PHP 5, PHP 7)

Constructs a new directory iterator from a path

public DirectoryIterator::__construct ( string $path )

Constructs a new directory iterator from a path.

Parameters:

path

The path of the directory to traverse.

Exception:

Throws an UnexpectedValueException if the path cannot be opened.

Throws a RuntimeException if the path is an empty string.

Changelog:

5.3.0

Throws UnexpectedValueException if the path cannot be opened.

5.1.3

Throws RuntimeException if the path is an empty string.

5.1.0

Throws RuntimeException on error. Previously, threw Exception.

Examples:

A DirectoryIterator::__construct() example

This example will list the contents of the directory containing the script.

<?php
$dir = new DirectoryIterator(dirname(__FILE__));
foreach ($dir as $fileinfo) {
    if (!$fileinfo->isDot()) {
        var_dump($fileinfo->getFilename());
    }
}
?>