PHP递归遍历目录实用教程

本文深入讲解了PHP中高效、安全地递归遍历目录的最佳实践，重点推荐使用内置的RecursiveDirectoryIterator与RecursiveIteratorIterator组合方案——它比手写递归更简洁健壮、天然规避路径拼接错误和类型判断漏洞；内容涵盖基础结构展示、按扩展名或文件大小精准筛选、权限异常与符号链接环路的安全防护，以及构建树形数组等实战场景，并强调了深度控制、可读性校验和内存优化等关键细节，助你写出稳定、可维护、符合PHP惯用法的目录处理代码。

PHP递归遍历目录，核心是用 RecursiveDirectoryIterator 配合 RecursiveIteratorIterator，既简洁又健壮，比手写递归函数更安全、更易控制。

基础递归遍历：列出所有文件和子目录

这是最常用场景，适合快速查看整个目录结构：

• 创建 RecursiveDirectoryIterator 实例，传入根路径（自动跳过 . 和 ..）
• 用 RecursiveIteratorIterator 包装它，启用深度优先遍历
• 遍历迭代器，用 getFilename() 获取名称，isFile()/isDir() 判断类型

示例代码：

$it = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator('/path/to/dir'),
    RecursiveIteratorIterator::CHILD_FIRST
);

foreach ($it as $file) {
    echo str_repeat('  ', $it->getDepth()) . $file->getFilename();
    if ($file->isDir()) echo ' [DIR]';
    echo PHP_EOL;
}

按条件筛选文件：只找特定扩展名或大小范围

实际开发中往往不需要全部内容，比如只查 .php 文件或大于 10KB 的日志：

• 在循环中加判断：例如 pathinfo($file->getFilename(), PATHINFO_EXTENSION) === 'php'
• 用 $file->getSize() 获取字节数，注意符号链接需用 getRealPath() 再 stat
• 也可用 RegexIterator 或自定义 FilterIterator 封装逻辑，提高复用性

安全遍历：避免权限错误和无限软链

生产环境必须处理异常，否则脚本可能中断：

• 用 try...catch 捕获 UnexpectedValueException（如无权限读取某子目录）
• 默认情况下 RecursiveDirectoryIterator 会追踪符号链接，若目标形成环路会报错；可传入标志 FilesystemIterator::SKIP_DOTS | FilesystemIterator::FOLLOW_SYMLINKS 并配合 setMaximumDepth() 限制层级
• 建议始终检查 $file->isReadable() 再操作内容

构建文件结构数组：生成树形数据供前端或API使用

常见于后台资源管理、静态站点生成等场景：

• 遍历时根据 $it->getDepth() 判断层级，用递归或栈方式组装嵌套数组
• 每个节点至少包含 name、type（file/dir）、path（相对或绝对）
• 如需性能优化，可用 iterator_to_array($it, false) 转为索引数组再处理，但注意内存占用

基本上就这些。用好内置迭代器类，不用自己拼路径、判类型、管深度，既少出错也更符合PHP惯用法。

到这里，我们也就讲完了《PHP递归遍历目录实用教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！