GlobIterator::__construct

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

GlobIterator::__construct — Constrói um diretório usando glob

Descrição

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

Constrói um novo iterador de diretório a partir de uma expressão glob.

Parâmetros

pattern: Um padrão glob().
flags: Sinalizadores de opção, os sinalizadores podem ser uma máscara de bits das constantes FilesystemIterator.

Erros/Exceções

Lança uma UnexpectedValueException se o diretório definido em directory não existir.

Lança um ValueError se o diretório definido em directory for uma string vazia.

Registro de Alterações

Versão	Descrição
8.0.0	Agora lança um ValueError se `directory` for uma string vazia; anteriormente lançava um RuntimeException.

Exemplos

Exemplo #1 Exemplo de GlobIterator

<?php
$iterator = new GlobIterator('*.dll', FilesystemIterator::KEY_AS_FILENAME);

if (!$iterator->count()) {
    echo 'Sem correspondência';
} else {
    $n = 0;

    printf("Corresponderam %d item(s)\r\n", $iterator->count());

    foreach ($iterator as $item) {
        printf("[%d] %s\r\n", ++$n, $iterator->key());
    }
}
?>

O exemplo acima produzirá algo semelhante a:

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

Veja Também

DirectoryIterator::__construct() - Constrói um novo iterador de diretório a partir de um caminho
GlobIterator::count() - Obtém o número de diretórios e arquivos
glob() - Acha caminhos que combinam com um padrão

add a note

User Contributed Notes 2 notes

down

ozana at omdesign dot cz ¶

10 years ago


GlobIterator doesn’t have a way to support GLOB_BRACE!

<?php
$iterator = new GlobIterator(getcwd. '/*.{php,txt}'); // generate an empty array
?>

down

info at ensostudio dot ru ¶

4 years ago


Fix problem with braces in template:
<?php
class GlobStreamWrapper
{
    private $generator;

    protected function createGenerator(array $paths): Generator
    {
        return yield from $paths;
    }

    public function dir_opendir(string $pattern, int $options = 0): bool
    {
        $pattern = substr($pattern, 7); // crop 'glob://' prefix
        $pattern = str_replace(['\\', '/'], DIRECTORY_SEPARATOR, $pattern);
        $paths = (array) glob($pattern, GLOB_BRACE | GLOB_NOSORT);
        $this->generator = $this->createGenerator($paths);
        return $this->generator->valid();
    }

    public function dir_readdir(): string
    {
        $path = $this->generator->current() ?: '';
        $this->generator->next();
        return $path;
    }

    public function dir_rewinddir(): bool
    {
       $this->generator->rewind();
        return $this->generator->valid();
    }

    public function dir_closedir(): bool
    {
        $this->generator = null;
        return true;
    }
}
?>
Replace glob wrapper:
<?php
stream_wrapper_unregister('glob');
stream_wrapper_register('glob', 'GlobStreamWrapper');
?>
Example:
<?php
$iterator = new GlobIterator(__DIR__ . '/{application,system}/src/*.php');
while ($iterator->valid()) {
    echo $iterator->current()->getFilename() . '</br>';
    $iterator->next();
}
?>

add a note