Constructs a new directory iterator from a path
  • « DirectoryIterator
    		•   
  • DirectoryIterator::current »
    		•

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