PHP遍历文件夹所有文件的实现方法

本文深入解析了PHP中遍历文件夹的三种主流方法——scandir()、RecursiveDirectoryIterator+RecursiveIteratorIterator组合以及glob()，重点对比了它们在简洁性、递归能力、内存占用、权限容错和健壮性方面的关键差异；指出scandir()虽直接但需手动过滤点文件并处理自然排序，glob()看似便捷却易致内存溢出且不具原生递归能力，而基于迭代器的方案才是PHP官方推荐的生产级选择——它惰性加载、自动跳过.和..、支持深度控制，并强调必须用try/catch捕获权限异常以避免中断，真正兼顾效率、安全与稳定性。

用 scandir() 获取目录内容但要注意排序和隐藏文件

scandir() 是最直接的内置函数，返回包含当前目录下所有条目（包括 . 和 ..）的数组，默认按字母升序排列。它不递归，只看一层。

• 必须手动过滤掉 . 和 ..，否则后续 is_dir() 或 is_file() 可能出错
• 注意系统可能返回隐藏文件（如 .gitignore），如果业务不需要，得用 array_filter() 配合 str_starts_with($name, '.') === false
• 排序是字符串级的，file10.txt 会排在 file2.txt 前面，如需自然排序，得用 natcasesort() 重排数组

递归遍历用 RecursiveDirectoryIterator + RecursiveIteratorIterator

这是 PHP 原生推荐的递归方式，比手写递归更健壮，自动跳过无法访问的子目录（如权限不足），且支持 SKIP_DOTS 标志省去手动过滤。

• 初始化时传入 FilesystemIterator::SKIP_DOTS，可直接排除 . 和 ..
• 遍历时用 getFilename() 拿文件名，getPathname() 拿完整路径，isFile()/isDir() 判断类型
• 若需限制深度（比如最多进 3 层子目录），可在构造 RecursiveIteratorIterator 时传入第三个参数 RecursiveIteratorIterator::SELF_FIRST 并配合计数器控制

$iter = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator('/path', FilesystemIterator::SKIP_DOTS),
    RecursiveIteratorIterator::LEAVES_ONLY
);
foreach ($iter as $file) {
    echo $file->getPathname() . "\n";
}

遇到 Permission denied 错误时别让脚本崩掉

遍历中碰到无读取权限的目录（如 /proc 下某些子目录），RecursiveDirectoryIterator 默认抛出 UnexpectedValueException，导致整个循环中断。

• 必须用 try/catch 包裹迭代过程，捕获 UnexpectedValueException 并继续下一次迭代
• 不要用 @ 抑制错误——它无法屏蔽迭代器内部异常，且掩盖问题
• 若需记录哪些路径被跳过，可在 catch 块里写日志，例如 error_log("Skip: " . $e->getMessage());

大目录下性能差异：用 glob() 还是迭代器？

glob('/path/*') 看起来简洁，但它一次性把所有匹配结果加载进内存，且不支持递归（除非嵌套调用，逻辑复杂）。对含上万文件的目录，容易内存溢出或超时。

• RecursiveDirectoryIterator 是惰性迭代，每次只取一个条目，内存占用稳定
• glob() 在路径中使用 **（如 glob('/path/**/*', GLOB_BRACE)）需要 PHP ≥ 7.3 且开启 glob() 的 GLOB_BRACE 支持，兼容性不如迭代器
• 如果只是找特定后缀文件（如所有 .log），用 RegexIterator 包裹迭代器比 glob() 更可控、更省内存

实际递归遍历的健壮写法，往往就卡在权限处理和内存控制这两处。漏掉 SKIP_DOTS 或没包 try/catch，线上一跑就挂；而盲目用 glob() 处理海量小文件，可能让脚本在半路 OOM。

理论要掌握，实操不能落！以上关于《PHP遍历文件夹所有文件的实现方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！