array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.glob.php', 1 => 'glob', 2 => 'Находит файловые пути, которые совпадают с шаблоном', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Функции файловой системы', ), 'prev' => array ( 0 => 'function.fwrite.php', 1 => 'fwrite', ), 'next' => array ( 0 => 'function.is-dir.php', 1 => 'is_dir', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', '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 — Находит файловые пути, которые совпадают с шаблоном

Описание

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

Функция glob() ищет в текущей файловой системе пути, которые совпали с шаблоном pattern по правилам функции glob() стандартной C-библиотеки libc, которые аналогичны правилам стандартных командных оболочек.

Поведение функции в системах Unix и macOS определяется реализацией функции glob() в системе. В ОС Windows реализация функции соответствует определению 1003.2 стандарта POSIX для функции glob() и включает расширение для обработки соглашения [!...] для отрицания диапазона.

Список параметров

pattern

Шаблон. Параметр не раскрывает символы тильды и не подставляет параметры.

Специальные символы:

  • * — Соответствует нулю или большему количеству символов.
  • ? — Соответствует ровно одному символу (любому символу).
  • [...] — Соответствует одному символу из группы символов. Символ соответствует символу, который не входит в группу, если первый символ !.
  • {a,b,c} — Соответствует одной строке из группы строк, разделённых запятой, если указали флаг GLOB_BRACE.
  • \ — Экранирует следующий символ, если только не указали флаг GLOB_NOESCAPE.

flags

Константа семейства GLOB_*.

Возвращаемые значения

Функция возвращает массив с совпадениями путей файлов или директорий, пустой массив, если файлы не совпали, или false, если возникла ошибка. Названия отсортируются в буквенно-цифровом порядке, если только не указали флаг GLOB_NOSORT.

Примеры

Пример #1 Способ подмены функцией glob() функции opendir() и дружественных функции

<?php

foreach (glob("*.txt") as $filename) {
echo "Размер файла $filename в байтах — " . filesize($filename) . "\n";
}

?>

Вывод приведённого примера будет похож на: 

Размер файла funclist.txt в байтах — 44686
Размер файла funcsummary.txt в байтах — 267625
Размер файла quickref.txt в байтах — 137820

Пример #2 Пример с усложнённым шаблоном

<?php

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

?>

Вывод приведённого примера будет похож на: 

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

Примечания

Замечание: Функция неприменима для работы с удалёнными файлами, поскольку файл должен быть доступен через файловую систему сервера.

Замечание: Функция недоступна в системах наподобие старой Sun OS.

Смотрите также