DirectoryIterator::__construct

    (PHP 5, PHP 7, PHP 8)

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

    Description

    publicDirectoryIterator::__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

    VersionDescription
    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());
    }
    }
    ?>
    To Top