scandir适合快速列出单层目录内容，不递归；RecursiveDirectoryIterator支持真递归但需配合RecursiveIteratorIterator使用；glob简洁但存在安全与兼容性隐患。
scandir 适合快速列目录，但不递归
用 scandir 就是图个快、图个简单：它只读一层，返回当前目录下所有文件和子目录名的数组，不深入子目录。适合做路径检查、生成简易列表、或配合 foreach 手动控制层级。
常见错误是以为它能自动遍历整个树形结构——结果只拿到第一层就停了，还误以为代码没生效。
-
scandir返回值包含.和..，实际使用前得用array_diff或条件过滤掉 - 不支持过滤类型（比如只拿 .php 文件），得靠
pathinfo或glob配合 - 遇到权限不足的子目录会直接报
Warning: scandir(): Permission denied，不抛异常，容易静默失败 - 在大目录下性能不错，但嵌套深时自己写递归容易栈溢出或逻辑错乱
RecursiveDirectoryIterator 是真递归，但得配 RecursiveIteratorIterator
单独 new RecursiveDirectoryIterator 只是创建了一个迭代器对象，不能直接 foreach —— 它必须包一层 RecursiveIteratorIterator 才能线性展开。这是新手最常卡住的地方：写了半天循环没输出，其实是忘了“套壳”。
它天然支持跳过 ./..、按需过滤、捕获异常，也方便和 RegexIterator 或 CallbackFilterIterator 组合。
立即学习“PHP免费学习笔记（深入）”；
- 默认行为是“深度优先”，想广度优先得传第二个参数
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 挂载点延迟响应……这些在标准迭代器里都有现成兜底。
真正难的不是选函数，而是想清楚：你到底需要路径、还是文件内容、还是元数据？要不要中断？允不允许部分失败？这些决定了该往哪条路走，而不是看谁写起来最短。
