DirectoryIterator
PHP Manual

DirectoryIterator::__construct

Constructs a new directory iterator from a path

Description

public DirectoryIterator::__construct ( string $path )

Constructs a new directory iterator from a path.

Parameters

path

The path of the directory to traverse.

Errors/Exceptions

Throws an UnexpectedValueException if the path cannot be opened.

Throws a RuntimeException if the path is an empty string.

Changelog

Version Description
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

Example #1 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());
    }
}
?>

See Also

  • SplFileInfo
  • Iterator