DirectoryIterator::__construct

Constructs a new directory iterator from a path

&reftitle.description; public `DirectoryIterator::__construct` `string` `directory`

Constructs a new directory iterator from a path.

&reftitle.parameters;

`directory`

- The path of the directory to traverse.

&reftitle.errors;

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

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

&reftitle.changelog;

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

&reftitle.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());
        }
    }
    ?>

&reftitle.seealso;

- `SplFileInfo`
- `Iterator`