PHP怎样实现递归目录遍历_PHP实现递归目录遍历方法【操作】

聊到PHP递归目录遍历，不少开发者第一反应是掏出`scandir()`自己写递归，或者用`glob()`搞个模式匹配。这些方法不是不能用，但坑也不少。这里分享几个关键点：路径拼接出错、权限拒绝导致遍历中断、软链接引发无限循环——这些问题在实际项目中并不少见。 ## 用 `RecursiveDirectoryIterator` 遍历目录最稳 在PHP里做递归目录遍历，最稳的方案其实就藏在SPL扩展包里——`RecursiveDirectoryIterator`配合`RecursiveIteratorIterator`，这组组合拳打下来，基本不会出什么幺蛾子。它自动屏蔽了`.`和`..`，支持过滤、深度控制，而且完全不依赖shell命令，也不需要你手动拼接路径。 那问题出在哪儿？很多人习惯用`scandir()`手写递归，结果一遇到权限拒绝的目录（比如`/proc`下某些子目录），程序就崩了；或者路径拼接搞出`/a//b`这种双斜杠；再或者软链接没处理，直接陷入无限递归。 这里有几个实践经验： - 迭代过程一定要用`try/catch`包起来，因为遇到无权限目录时，会抛出`UnexpectedValueException` - 如果不需要跟随软链接，构造时传入`RecursiveDirectoryIterator::SKIP_DOTS`即可；默认就不跟随，这个设计很安全 - 遍历时直接用`$item->getPathname()`拿完整路径，用`$item->getFilename()`拿当前项名，别再自己调`basename()`了 ## 用 `scandir()` 手写递归要注意路径和异常 当然，如果项目还跑在PHP 5.2上，或者必须兼容极旧环境，那`scandir()`就是唯一的选择。但这时候边界和错误处理就得自己扛了。 最常见的报错是`Warning: scandir(/path/to/dir): failed to open dir`，说明权限不足或者路径根本不存在。更隐蔽的问题是Windows下的反斜杠——`\`会被当成转义字符，导致`is_dir()`返回false。 那怎么处理？ - 统一用`str_replace('\', '/', $path)`或者`realpath($path)`来规范路径分隔符 - `scandir()`返回的结果里包含`.`和`..`，必须显式过滤掉，用`array_diff($files, ['.', '..'])` - 每次进入子目录前，先判断`is_readable()`，再判断`is_dir()`，顺序不能颠倒——否则对不可读目录调用`is_dir()`可能静默失败 ## `glob()` 适合简单模式匹配，不适合深层遍历 `glob('path/**/*', GLOB_BRACE | GLOB_ONLYDIR)`看起来挺简洁，但实际限制不少。PHP 5.6+才支持`**`，`GLOB_ONLYDIR`不过滤符号链接，`GLOB_BRACE`在某些系统上压根不可用。 更关键的是，`glob()`是一次性返回所有匹配路径，内存占用会随着目录深度和文件数线性增长。遍历一个10万文件的目录，直接OOM的情况并不少见。 所以建议： - 仅用于单层或已知浅层结构，比如`config/*.php`这种场景 - 如果坚持用`**`，务必加`set_error_handler()`捕获`glob()`失败——它不抛异常，只触发warning - Linux下可以用`shell_exec('find ' . escapeshellarg($path) . ' -type f')`替代，但`escapeshellarg`必须严格包裹路径，否则有命令注入风险 ## 递归遍历时软链接和权限问题最容易被忽略 绝大多数示例代码都把软链接当成普通目录处理，结果就是无限循环——比如`/var/www/html -> /var/www/`这种。而权限问题更隐蔽，遍历到一半发现“部分目录没进来”，却查不出原因。 生产环境里，`/sys`、`/proc`、Docker容器挂载点这些地方，经常出现无权限子目录，或者软链接指向自身层级。 需要特别留意的是： - `RecursiveDirectoryIterator`默认不跟随软链接，这本身就是一种安全设计；如果需要跟随，显式加上`RecursiveDirectoryIterator::FOLLOW_SYMLINKS`，并配合`setMaxDepth()`防止失控 - 手写递归时，用`is_link($path)`提前判断，再决定跳过、报错还是记录 - 权限异常不要静默吞掉——至少用`error_log("skipped {$path}: " . $e->getMessage(), 4)`记到日志，否则排查时完全无迹可寻