PHP递归遍历时应通过检查文件名是否以.开头来识别并跳过隐藏文件，Linux/macOS下此法覆盖绝大多数场景；Windows需PHP 8.3+的is_hidden()函数，但兼容性差，推荐统一用文件名前缀判断。
PHP递归遍历时如何识别并跳过隐藏文件？
Linux/macOS 下以 . 开头的文件或目录（如 .git、.DS_Store）默认视为隐藏文件；Windows 下则依赖文件系统属性（如 FILE_ATTRIBUTE_HIDDEN）。PHP 的 scandir() 或 DirectoryIterator 不会自动过滤它们，必须显式判断。
最可靠的方式是检查文件名是否以 . 开头——这覆盖绝大多数实际场景，且兼容性好、开销低。Windows 上若需严格按属性过滤，得用 is_hidden()（PHP 8.3+）或调用 shell_exec('attrib '.$path)（不推荐，跨平台差）。
-
scandir()返回的数组包含.和..，务必先用array_diff($files, ['.', '..'])剔除 - 对每个条目用
substr($name, 0, 1) === '.'判断是否隐藏，比正则更快更安全 - 不要只检查扩展名（如
.gitignore是普通文件，不应跳过），而应检查文件/目录名本身
用 RecursiveIteratorIterator 跳过隐藏项的写法
基于 SPL 的迭代器组合更简洁，且天然支持递归。关键在于自定义 FilterIterator，而不是在循环里反复 if 判断。
下面是一个最小可用示例：
立即学习“PHP免费学习笔记（深入）”；
class SkipHiddenFiles extends FilterIterator
{
public function accept(): bool
{
$file = $this->current();
return !($file->isDot() || str_starts_with($file->getFilename(), '.'));
}
}
<p>$iterator = new RecursiveIteratorIterator(
new SkipHiddenFiles(new RecursiveDirectoryIterator('/path', FilesystemIterator::SKIP_DOTS))
);
foreach ($iterator as $file) {
echo $file->getPathname() . "\n";
}-
FilesystemIterator::SKIP_DOTS已跳过.和..，但无法跳过.env这类真实隐藏项，所以仍需str_starts_with() -
$file->isDot()只判断.和..，不能替代对隐藏名的判断 - 避免在
accept()中调用is_file()或is_dir()，会额外触发 stat，影响性能
为什么 glob() 不适合跳过隐藏文件？
glob() 默认不匹配以 . 开头的文件，但这是个陷阱：它只在 *当前层级* 忽略，且行为受 GLOB_BRACE 和 shell 环境影响，递归时不可靠。
-
glob('/path/*')确实跳过.git，但glob('/path/**/*', GLOB_BRACE | GLOB_ONLYDIR)在部分 PHP 版本下会漏掉或报错 -
glob()无法区分“不存在”和“被权限拒绝”，错误处理困难 - 没有统一方式控制是否包含符号链接、是否排序，灵活性远不如 SPL 迭代器
注意 Windows 隐藏属性的边界情况
如果你的应用明确要支持 Windows 并尊重系统隐藏属性（比如用户手动设置了 attrib +H file.txt），那么仅靠文件名前缀不够。
PHP 8.3 引入了 is_hidden() 函数，可直接使用：
if (is_hidden($path)) {
continue;
}但要注意：
- PHP 8.3 以下版本没有该函数，强行调用会 fatal error
-
is_hidden()在 Linux/macOS 下始终返回false，它只读取 Windows 文件属性 - 混合环境（如 WSL）下行为不一致，建议优先用文件名前缀方案保持一致性
真正需要跨平台精确隐藏判断的场景极少，多数项目只需跳过 . 开头项——别为小概率需求增加复杂度。
