PHP 8.4.2 Released!

glob

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

glob寻找与模式匹配的文件路径

说明

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

glob() 函数依照 libc glob() 函数使用的规则寻找所有与 pattern 匹配的文件路径,类似于一般 shells 所用的规则一样。

Unix 系统和 macOS 上的行为由系统级 glob() 实现来决定。在 Windows 上,使用符合 POSIX 1003.2 定义的 glob() 实现,它包含一个扩展来处理 [!...] 约定以否定范围。

参数

pattern

匹配模式(pattern)。 不进行缩写扩展或参数替代。

特殊字符:

  • * - 匹配零个或多个字符。
  • ? - 只匹配单个字符(任意字符)。
  • [...] - 匹配一组字符中的一个字符。 如果第一个字符是 !,则为否定模式, 即匹配不在这组字符中的任意字符。
  • \ - 只要没有使用 GLOB_NOESCAPE 标记,该字符会转义后面的字符。

flags

任何 GLOB_* 常量。

返回值

返回包含有匹配文件和目录的数组,没有匹配文件时返回空数组,出错返回 false。除非使用了 GLOB_NOSORT,否则名称将按字母顺序排序。

示例

示例 #1 怎样用 glob() 方便地替代 opendir() 和相关函数

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

以上示例的输出类似于:

funclist.txt size 44686
funcsummary.txt size 267625
quickref.txt size 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)。

参见

添加备注

用户贡献的备注 1 note

up
4
Anonymous
3 years ago
Include dotfiles excluding . and .. special dirs with .[!.]*

<?php
$all_files
= array_merge(glob('.[!.]*'), glob('*'));
// or
$all_files = glob('{.[!.],}*', GLOB_BRACE);
?>
To Top