DirectoryIterator
DirectoryIterator::current
DirectoryIterator
PHP Manual

# DirectoryIterator::__construct

(PHP 5)

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

### Description

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

Constructs a new directory iterator from a path.

### Parameters

`path`

  The path of the directory to traverse.

### Errors/Exceptions

Throws an UnexpectedValueException if the `path` cannot be opened.

Throws a RuntimeException if the `path` is an empty string.

### Changelog

Version | Description
--- | ---
5.3.0 | Throws UnexpectedValueException if the `path` cannot be opened.
5.1.3 | Throws RuntimeException if the `path` is an empty string.
5.1.0 | Throws RuntimeException on error. Previously, threw Exception.

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

DirectoryIterator
DirectoryIterator::current
DirectoryIterator
PHP Manual