PHP递归遍历目录推荐使用RecursiveDirectoryIterator配合RecursiveIteratorIterator，简洁健壮、安全可控；支持基础遍历、条件筛选、异常处理及树形结构构建。
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 的日志：
立即学习“PHP免费学习笔记（深入）”；
- 在循环中加判断：例如
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惯用法。
