PHP怎么遍历目录结构_scandir与RecursiveDirectoryIterator对比【指南】-php教程-PHP中文网

scandir适合快速列出单层目录内容，不递归；RecursiveDirectoryIterator支持真递归但需配合RecursiveIteratorIterator使用；glob简洁但存在安全与兼容性隐患。

php怎么遍历目录结构_scandir与recursivedirectoryiterator对比【指南】

scandir 适合快速列目录，但不递归

用 scandir 就是图个快、图个简单：它只读一层，返回当前目录下所有文件和子目录名的数组，不深入子目录。适合做路径检查、生成简易列表、或配合 foreach 手动控制层级。

常见错误是以为它能自动遍历整个树形结构——结果只拿到第一层就停了，还误以为代码没生效。

scandir 返回值包含 . 和 ..，实际使用前得用 array_diff 或条件过滤掉
不支持过滤类型（比如只拿 .php 文件），得靠 pathinfo 或 glob 配合
遇到权限不足的子目录会直接报 Warning: scandir(): Permission denied，不抛异常，容易静默失败
在大目录下性能不错，但嵌套深时自己写递归容易栈溢出或逻辑错乱

RecursiveDirectoryIterator 是真递归，但得配 RecursiveIteratorIterator

单独 new RecursiveDirectoryIterator 只是创建了一个迭代器对象，不能直接 foreach —— 它必须包一层 RecursiveIteratorIterator 才能线性展开。这是新手最常卡住的地方：写了半天循环没输出，其实是忘了“套壳”。

它天然支持跳过 ./..、按需过滤、捕获异常，也方便和 RegexIterator 或 CallbackFilterIterator 组合。

默认行为是“深度优先”，想广度优先得传第二个参数 RecursiveIteratorIterator::CHILD_FIRST
遇到不可读目录会抛 UnexpectedValueException，建议用 try/catch 包裹单次 next() 或 current()
如果只要文件不要目录，加一句 $iterator->accept() && $iterator->isFile() 判断更稳妥
注意 getSubPathname() 返回的是相对路径（不含根），getPathname() 才是完整路径

用 glob 走捷径？小心 shell 字符和编码陷阱

虽然标题没提 glob，但它常被拿来和前两者对比——尤其想一次性匹配特定后缀时。它快、短、像 shell，但隐患不少。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Windows 下路径分隔符、中文路径、带空格或方括号的文件名都可能导致 glob 返回空数组，且不报错。PHP 7.4+ 对 UTF-8 支持稍好，但依旧不保证。

glob 不支持递归通配符（**）在所有系统上都可靠；PHP 7.4+ 加 GLOB_BRACE 也有限制
返回的是纯路径字符串数组，没有元信息（比如是否可读、修改时间），要再 stat 一次
若路径含变量，务必用 escapeshellarg 处理，否则可能执行意外命令（尤其拼接用户输入时）
比起 RecursiveDirectoryIterator，它无法中断遍历、无法动态跳过某子树

选哪个？看你的控制粒度要多细

如果只是“列出 uploads/ 下所有 .jpg”，glob('uploads/**/*.jpg', GLOB_BRACE) 最省事；如果要“遍历 vendor/ 并跳过 tests/ 目录、记录每个 PHP 文件的最后修改时间、遇到权限问题打日志继续”，那就只能用 RecursiveDirectoryIterator + 自定义 FilterIterator。

scandir 的真实定位是“轻量级探路工具”，不是通用遍历方案。很多人一开始用它写递归函数，后期维护才发现边界 case 漏了一堆：符号链接循环、超长路径、NFS 挂载点延迟响应……这些在标准迭代器里都有现成兜底。

真正难的不是选函数，而是想清楚：你到底需要路径、还是文件内容、还是元数据？要不要中断？允不允许部分失败？这些决定了该往哪条路走，而不是看谁写起来最短。