array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.glob.php', 1 => 'glob', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funções do sistema de arquivos', ), 'prev' => array ( 0 => 'function.fwrite.php', 1 => 'fwrite', ), 'next' => array ( 0 => 'function.is-dir.php', 1 => 'is_dir', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/filesystem/functions/glob.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
glob — Acha caminhos que combinam com um padrão
A função glob() procura por todos os caminhos
que combinem com o padrão pattern
de acordo
com as regras usadas pela função glob() da libc, que é semelhante
às regras usadas por shells comuns.
pattern
O padrão. Não é feita nenhuma expansão de til ou substituição de parâmetros.
Caracteres especiais:
*
- Corresponde a zero ou mais caracteres.
?
- Corresponde a exatamente um caractere (qualquer caractere).
[...]
- Corresponde a um caractere de um grupo de
caracteres. Se o primeiro caractere for !
,
corresponde a qualquer caractere que não estiver no grupo.
\
- Faz escape no caractere seguinte,
exceto quando a opção GLOB_NOESCAPE
for usada.
flags
Opções válidas:
GLOB_BRACE
(int)
Nota:
GLOB_BRACE
não está disponível em alguns sistemas não-GNU, como Solaris ou Alpine Linux.
GLOB_ERR
(int)
GLOB_ONLYDIR
(int)
GLOB_MARK
(int)
GLOB_NOSORT
(int)
GLOB_NOCHECK
(int)
GLOB_NOESCAPE
(int)
GLOB_AVAILABLE_FLAGS
(int)
GLOB_*
combinadas.
Equivalente a 0
| GLOB_BRACE
|
GLOB_MARK
| GLOB_NOSORT
|
GLOB_NOCHECK
| GLOB_NOESCAPE
|
GLOB_ERR
| GLOB_ONLYDIR
Retorna um array contendo os arquivos/diretórios que corresponderam, um array
vazio se nenhum arquivo correspondeu ou false
em caso de erro.
Nota:
Em alguns sistemas é impossível distinguir entre resultado vazio ou um erro.
Exemplo #1 Modo conveniente de como glob() pode susbstituir opendir() e companhia.
<?php
foreach (glob("*.txt") as $arquivo) {
echo "tamanho de $arquivo " . filesize($arquivo) . "\n";
}
?>
O exemplo acima produzirá algo semelhante a:
tamanho de funclist.txt 44686 tamanho de funcsummary.txt 267625 tamanho de quickref.txt 137820
Nota: Esta função não funcionará em arquivos remotos, pois o arquivo a ser examinado deve ser acessível através do sistema de arquivos do servidor.
Nota: Esta função não está disponível em alguns sistemas (ex.: antigo Sun OS).