PHP遍历目录：scandir与RecursiveDirectoryIterator对比

本文深入对比了PHP中三种常用目录遍历方式——scandir、RecursiveDirectoryIterator和glob，揭示它们各自的核心能力与隐性陷阱：scandir轻快简洁但仅限单层、易因忽略`.`/`..`或权限警告导致静默失败；RecursiveDirectoryIterator真正支持可控递归，配合RecursiveIteratorIterator可灵活处理异常、过滤、遍历顺序及元数据，是复杂场景的可靠选择；而glob虽语法简捷，却在跨平台兼容性、安全性（如shell注入风险）、元信息缺失和递归可靠性上存在明显短板。文章强调，技术选型不应只看代码行数，而应回归实际需求——是否需要中断遍历、容忍部分失败、获取文件属性，或动态跳过子树，这才是决定使用哪种工具的根本依据。

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，但隐患不少。

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 挂载点延迟响应……这些在标准迭代器里都有现成兜底。

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

理论要掌握，实操不能落！以上关于《PHP遍历目录：scandir与RecursiveDirectoryIterator对比》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！