Overview
KB
Technical FAQ
PHP Manual
CSS2 Manual
HTML Manual
JS Guide
JS Reference
PhpDock Manual
Nu-Coder Manual
PhpExpress Manual
PHP Joomla
Development
Learn PHP
 
<DirectoryIteratorDirectoryIterator::current>
^DirectoryIteratorLast updated: Mon, 26 Oct 2026

DirectoryIterator::__construct

(PHP 5, PHP 7, PHP 8)

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

Description

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


<DirectoryIteratorDirectoryIterator::current>
^DirectoryIteratorLast updated: Mon, 26 Oct 2026