Manual do PHP
Anterior |  | Próxima

# glob

(PHP 4 >= 4.3.0, PHP 5)

glob -- Localiza diretórios/arquivos que combinem com o padrão

## Descrição

array glob ( string pattern [, int flags])

A função glob() procura por todos os caminhos de arquivos que batem com o padrão pattern de acordo com as regras do sistema operacional. Nenhuma expansão ou substituição de variável é realizada.

Retorna um array contendo os arquivos/diretórios localizados ou `FALSE` em caso de erro.

Flags válidas:

- `GLOB_MARK` - Acrescenta um hífem a cada item retornado

- `GLOB_NOSORT` - Retornam os arquivos confome eles aparecem no diretório (sem ordenação)

- `GLOB_NOCHECK` - Retorna o padrão de busca se nenhum arquivo for encontrado

- `GLOB_NOESCAPE` - Evita contra-barras para metacaracteres

- `GLOB_BRACE` - Expande {a,b,c} para procurar 'a', 'b', ou 'c'

- `GLOB_ONLYDIR` - Retorna somente diretórios que batam com o padrão (sem arquivos)

> Nota: Antes do PHP 4.3.3 `GLOB_ONLYDIR` não estava disponível no Windows e em outros sistemas que não utilizavam a biblioteca GNU C.

Exemplo 1. Maneira conveniente de como glob() pode substituir opendir() e similares.
`<?php foreach (glob("*.txt") as $filename) { echo "Tamanho de $filename " . filesize($filename) . "\n"; } /* Irá produzir algo como: Tamanho de funclist.txt 44686 Tamanho de funcsummary.txt 267625 Tamanho de quickref.txt 137820 */ ?>`

> Nota: Esta função não trabalha com arquivos remotos, de forma que o arquivo a ser examinado precisa ser acessível pelo sistema de arquivos do servidor.

Veja também opendir(), readdir(), closedir() e fnmatch().

Anterior | Principal | Próxima
fwrite | Acima | is_dir