array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.glob.php', 1 => 'glob', 2 => 'Búsqueda de rutas que coinciden con un patrón', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funciones del Sistema de Archivos', ), 'prev' => array ( 0 => 'function.fwrite.php', 1 => 'fwrite', ), 'next' => array ( 0 => 'function.is-dir.php', 1 => 'is_dir', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/filesystem/functions/glob.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

glob

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

glob — Búsqueda de rutas que coinciden con un patrón

Descripción

glob(string $pattern, int $flags = 0): array|false

glob() busca todas las rutas que coinciden con el patrón pattern, siguiendo las reglas utilizadas por la función glob() de la libc, que son las mismas que las utilizadas por el Shell en general.

El comportamiento en sistemas Unix y macOS está determinado por la implementación de glob() del sistema. En Windows, se utiliza una implementación conforme a la definición POSIX 1003.2 de glob(), con una extensión para manejar la convención [!...] que permite negar un rango.

Parámetros

pattern

El patrón. No se realiza sustitución de tilde (~) ni de parámetro.

Caracteres especiales:

  • * - Asocia cero o más caracteres.
  • ? - Asocia exactamente un carácter (cualquier carácter).
  • [...] - Asocia un carácter de un conjunto de caracteres. Si el primer carácter es !, asocia cualquier carácter que no esté en este conjunto.
  • {a,b,c} - Asocia una cadena de un grupo de cadenas separadas por comas cuando se utiliza el flag GLOB_BRACE.
  • \ - Escapa el carácter siguiente, excepto cuando se utiliza el flag GLOB_NOESCAPE.

flags

Cualquiera de las constantes GLOB_*.

Valores devueltos

Devuelve un array que contiene los ficheros y directorios que coinciden con el patrón, un array vacío si no hay coincidencias, o false si ocurre un error. A menos que se utilice GLOB_NOSORT, los nombres serán ordenados alfabéticamente.

Ejemplos

Ejemplo #1 Un método práctico para reemplazar opendir() por glob()

<?php
foreach (glob("*.txt") as $filename) {
echo "$filename ocupa " . filesize($filename) . "\n";
}
?>

Resultado del ejemplo anterior es similar a:

funclist.txt ocupa 44686
funcsummary.txt ocupa 267625
quickref.txt ocupa 137820

Ejemplo #2 Ejemplo con un patrón más complejo

<?php
foreach (glob("path/*/*.{txt,md}", \GLOB_BRACE) as $filename) {
echo "$filename\n";
}
?>

Resultado del ejemplo anterior es similar a:

path/docs/mailinglist-rules.md
path/docs/README.md
path/docs/release-process.md
path/pear/install-pear.txt
path/Zend/README.md

Notas

Nota: Esta función no funciona con los archivos remotos, ya que el archivo examinado debe ser accesible en el sistema de archivos del servidor.

Nota: Esta función no está disponible en algunos sistemas (por ejemplo, viejos Sun OS).

Ver también