PHP目录递归遍历方法说明_PHP查找文件结构实战-php教程-PHP中文网

PHP目录递归遍历方法说明_PHP查找文件结构实战

舞姬之光

发布： 2025-12-14 13:09:09

原创

617人浏览过

PHP递归遍历目录推荐使用RecursiveDirectoryIterator配合RecursiveIteratorIterator，简洁健壮、安全可控；支持基础遍历、条件筛选、异常处理及树形结构构建。

php目录递归遍历方法说明_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 的日志：

立即学习“PHP免费学习笔记（深入）”；

美图AI开放平台

美图推出的AI人脸图像处理平台

111

查看详情

在循环中加判断：例如 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() 再操作内容