PHP 8.1 推荐用 RecursiveDirectoryIterator + RecursiveIteratorIterator 递归遍历目录，自动跳过 . 和 ..、支持异常捕获、逻辑清晰；手写递归易出错，需手动过滤、校验可读性、避免静默跳过与内存溢出。
PHP 8.1 中递归遍历目录所有文件，核心是“深入每一层、不跳过任何分支、安全跳过非法项”。手写递归容易因忽略返回值或未处理异常而中断；用原生迭代器则更健壮、简洁、符合现代 PHP 风格。关键不在“能不能写出来”，而在“会不会漏、稳不稳定、好不好维护”。
手写递归：必须检查返回值，不能无条件 return
常见错误是：一进子目录就 return $this->search(...)，导致后续同级目录和文件全被跳过。正确做法是只在真正找到目标时才提前返回，否则继续遍历：
- 用
scandir()读取当前目录，手动过滤.和.. - 拼路径时统一用
DIRECTORY_SEPARATOR或结尾加/，避免 Windows/Linux 路径问题 - 对每个条目先判断类型：
is_dir()进入递归，is_file()收集结果 - 递归调用后检查返回值，仅当非
false才返回，否则继续循环
推荐方案：RecursiveDirectoryIterator + RecursiveIteratorIterator
这是 PHP SPL 提供的标准递归遍历方式，自动跳过 . 和 ..，支持权限异常捕获，代码更短、逻辑更清晰：
- 初始化时传入
FilesystemIterator::SKIP_DOTS，省去手动过滤 - 用
RecursiveIteratorIterator::LEAVES_ONLY只遍历文件（跳过目录节点） - 遍历时用
$file->isFile()二次确认，再调用getPathname()获取完整路径 - 在外层 try/catch 包裹整个 foreach，捕获
UnexpectedValueException（如权限不足），避免中断
实际使用中要避开的三个坑
很多代码本地能跑，上线就报错或漏文件，往往栽在这几点：
立即学习“PHP免费学习笔记（深入）”；
-
路径不可读不报错但静默跳过：
is_readable($path)必须在进入前校验，尤其在容器或共享主机环境 -
隐藏文件干扰结果：如
.git、.env、.DS_Store，需额外判断$file->getFilename()[0] === '.'并跳过 -
大目录内存溢出：不用
glob()（它把所有匹配路径一次性加载进内存），优先选迭代器方式，必要时加深度限制或用生成器 yield 分批返回
补充：快速获取单层文件，别滥用递归
如果只要当前目录下的文件（不含子目录），完全不需要递归：
-
scandir()+is_file()过滤，最轻量 -
glob($dir . '/*')更简洁，但注意它不区分文件/目录，需配合is_file()再筛一次 -
DirectoryIterator面向对象写法清晰，自动跳过./..，适合中等规模目录
