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

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

pattern

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

flags

Допустимые флаги:

GLOB_MARK - Добавляет слеш к каждой возвращаемой директории.
GLOB_NOSORT - Возвращает файлы в том виде, в котором они содержатся в директории (без сортировки). Если этот флаг не указан, то имена сортируются по алфавиту.
GLOB_NOCHECK - Возвращает шаблон поиска, если с его помощью не был найден ни один файл.
GLOB_NOESCAPE - Обратные слеши не экранируют метасимволы.
GLOB_BRACE - Раскрывает {a,b,c} для совпадения с 'a', 'b' или 'c'.
GLOB_ONLYDIR - Возвращает только директории, совпадающие с шаблоном.
GLOB_ERR - Останавливается при ошибках чтения (например, директории без права чтения), по умолчанию ошибки игнорируются.

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

Возвращает массив, который содержит совпадающие файлы/директории, пустой массив в случае отсутствия совпадения или FALSE в случае ошибки.

Замечание:
На некоторых системах невозможно отличить отсутствие совпадения и ошибку.

Список изменений

Версия	Описание
5.1.0	Добавлена константа `GLOB_ERR`

Примеры

Пример #1 Удобный способ, как при помощи glob() можно заменить opendir() и её друзей.


<?php
foreach (glob("*.txt") as $filename) {
    echo "$filename размер " . filesize($filename) . "\n";
}
?>

Результатом выполнения данного примера будет что-то подобное:

funclist.txt размер 44686
funcsummary.txt размер 267625
quickref.txt размер 137820

Примечания

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

Замечание: Эта функция недоступна на некоторых системах (например, старой Sun OS).

Замечание: Флаг GLOB_BRACE недоступен на некоторых не GNU-системах, например, Solaris.

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

opendir() - Открывает дескриптор каталога
readdir() - Получает элемент каталога по его дескриптору
closedir() - Освобождает дескриптор каталога
fnmatch() - Проверяет совпадение имени файла с шаблоном

Вернуться к: Файловая система