Constructs a new directory iterator from a path

- « DirectoryIterator

- DirectoryIterator::current »

- PHP Manual
- DirectoryIterator
- Constructs a new directory iterator from a path

# DirectoryIterator::__construct

(PHP 5, PHP 7, PHP 8)

DirectoryIterator::__construct — Constructs a new directory iterator from a path

### Description

public DirectoryIterator::__construct(string `$directory`)

Constructs a new directory iterator from a path.

### Parameters

`directory`

  The path of the directory to traverse.

### Errors/Exceptions

Throws an UnexpectedValueException if the `directory` does not exist.

Throws a ValueError if the `directory` is an empty string.

### Changelog

Version | Description
--- | ---
8.0.0 | Now throws a ValueError if `directory` is an empty string; previously it threw a RuntimeException.

### 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