递归函数需手动设置终止条件，php无内置自动遍历目录函数；scandir()仅读单层，递归逻辑须自写，须用is_dir()和is_readable()校验、过滤.和..，推荐用realpath()标准化路径，注意中文路径乱码、大目录超时及内存溢出问题。
递归函数必须手动控制终止条件，否则会无限调用
PHP 本身不提供内置的「自动递归遍历目录」函数，scandir() 或 opendir() 只能读取单层内容。递归逻辑必须由你自己写清楚：什么时候继续深入子目录，什么时候停止。最常见错误是忘记判断是否为目录，导致对文件调用 opendir() 报 Warning：opendir(): Not a directory；或者没过滤掉 . 和 ..，造成路径循环跳转。
实操建议：
- 每次进入新路径前，先用
is_dir()确认是目录，再用is_readable()检查权限 - 跳过
.和..是硬性要求，可用array_diff(scandir($path), ['.', '..'])过滤 - 递归调用时传入的是子目录的绝对路径（推荐用
realpath()标准化），避免相对路径拼接出错
用 scandir() + 递归比 opendir() 更简洁，但要注意返回值顺序
scandir() 返回有序数组（默认 ASC），包含 . 和 ..，适合快速遍历；opendir() 配合 readdir() 是流式读取，内存更省但代码略长。多数场景直接用 scandir() 更直觉。
示例核心片段：
function findFiles($dir, $ext = '') {
$files = [];
$items = array_diff(scandir($dir), ['.', '..']);
foreach ($items as $item) {
$path = $dir . DIRECTORY_SEPARATOR . $item;
if (is_dir($path)) {
$files = array_merge($files, findFiles($path, $ext));
} elseif (empty($ext) || pathinfo($item, PATHINFO_EXTENSION) === $ext) {
$files[] = $path;
}
}
return $files;
}
注意：scandir() 在某些旧版本 PHP 中对中文路径可能乱码（需确保脚本编码与文件系统一致），且不支持 glob 模式（如 *.php），扩展名匹配得自己写。
遇到大目录容易超时或爆内存，得加限制和迭代优化
递归深度过大（比如嵌套 200+ 层）或单目录含数万文件时，PHP 默认的 max_execution_time 和内存限制会触发 Fatal error: Allowed memory size exhausted 或 Maximum execution time exceeded。这不是代码写错了，而是规模问题。
可采取的应对方式：
- 用
set_time_limit(0)临时取消超时（仅 CLI 环境安全，Web 环境慎用） - 改用栈模拟递归（即迭代方式），用
array_push()/array_pop()管理待处理路径，显式控制深度和数量 - 加参数限制最大递归层级（如
$depth ）、单次最多收集文件数（防内存溢出） - 对结果不一次性返回全量数组，改为用
yield做生成器（PHP 5.5+），边找边处理
Windows 下路径分隔符和大小写敏感性容易引发误判
Windows 默认不区分文件名大小写，但 PHP 的 pathinfo()、glob() 或字符串比较仍按字面匹配。例如传入 $ext = 'PHP'，而实际文件是 index.php，就会漏掉。同时，DIRECTORY_SEPARATOR 在 Windows 是反斜杠 \，若手动拼接路径用了 /，多数情况也能工作（内核兼容），但遇到 realpath() 或某些扩展时可能解析异常。
稳妥做法：
- 扩展名统一转小写比较：
strtolower(pathinfo($item, PATHINFO_EXTENSION)) === strtolower($ext) - 始终使用
DIRECTORY_SEPARATOR拼接路径，不要硬写/或\ - 若需跨平台精确匹配（如只找
.log不找.LOG），应明确说明需求并加注释，避免后续维护者误改
error_log。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
