Construct a directory using glob

# GlobIterator::__construct

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

GlobIterator::__construct — Construct a directory using glob

### Description

public GlobIterator::__construct(string `$pattern`, int `$flags` = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO)

Constructs a new directory iterator from a glob expression.

### Parameters

`pattern`

  A glob() pattern.

`flags`

  Option flags, the flags may be a bitmask of the FilesystemIterator constants.

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

`<?php
$iterator = new GlobIterator('*.dll', FilesystemIterator::KEY_AS_FILENAME);
if (!$iterator->count()) {
echo 'No matches';
} else {
$n = 0;
printf("Matched %d item(s)\r\n", $iterator->count());
foreach ($iterator as $item) {
printf("[%d] %s\r\n", ++$n, $iterator->key());
}
}
?>`

The above example will output something similar to:

    Matched 2 item(s)
    [1] php5ts.dll
    [2] php_gd2.dll

### See Also

- DirectoryIterator::__construct() - Constructs a new directory iterator from a path
- GlobIterator::count() - Get the number of directories and files
- glob() - Find pathnames matching a pattern

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open