遍历文件夹不踩坑：PHP opendir与readdir的实战避坑指南

日常写 PHP 项目时，生成缩略图列表、清理过期缓存或者批量迁移素材，总绕不开“扫描目录”这一步。很多人一上手就翻官方文档，结果不是循环漏了隐藏文件，就是内存直接告警。其实 opendir 和 readdir 这对老牌搭档，语法并不复杂，但细节直接决定代码能否稳定跑在生产环境。把底层逻辑拆明白，文件操作就能写得既稳又轻。

打开目录资源是起手式。$handle = opendir($dir) 执行后会返回一个流标识符，务必留意返回值。路径不存在、权限不足或拼写错误时，函数会静默返回 false，后续调用直接抛致命错误。拿到句柄后进入核心遍历环节：while (($file = readdir($handle)) !== false)。这里强烈建议锁定严格比较符 !==。文件名若以数字 0 开头，弱类型 != false 会被判定为真，导致循环提前断裂，查 bug 时能让人怀疑人生。

刚碰这组函数的人，十有八九会栽在 . 和 .. 上。这是操作系统底层自带的目录索引，代表当前目录与上级目录。不加拦截直接参与业务逻辑，后面全得打补丁。在循环体头部直接过滤：if ($file === '.' || $file === '..') continue; 流程立刻清爽。拼接绝对路径时，放弃肉眼拼接斜杠，改用 $fullPath = $dir . DIRECTORY_SEPARATOR . $file; 无论是 Linux 还是 Windows 部署，路径分隔符自动适配，跨服务器迁移少一半兼容性烦恼。

文件清单跑完了，closedir($handle) 绝不能省略。不少教程认为脚本结束会自动回收，但在长驻进程或高频请求中，未显式关闭的目录句柄会持续占用系统文件描述符（FD）。一旦触碰内核上限，后续所有网络连接都会瞬间雪崩。稳妥的做法是在循环末尾主动释放，或直接用 try-finally 结构做安全兜底，确保无论中间是否抛出异常，句柄都能准时退场。

面对普通大小的目录，这套组合拳足够干练；但如果单次要扫描数万个文件或深层嵌套的归档目录，指针遍历的性能损耗会逐渐显现。此时建议切换到 DirectoryIterator。它基于 C 扩展实现，原生自带递归开关、访问控制与安全过滤，还能顺手提取文件大小、权限位和mtime属性，少写大量边界判断代码。若是只是定时任务清一次历史日志，保留原方法并微调 max_execution_time，依然是最快最省力的选择。

遍历目录本质上是跟文件系统确认状态。盯紧严格比较、拦截双点符号、及时释放句柄，基础代码就立住了。工具选型没有绝对优劣，只有场景匹配。摸透指针迭代的运行机理，结合数据规模灵活替换迭代器，写出的文件处理模块自然扎实耐造。下次再遇到需要翻动文件夹的需求，按这条路径走一遍，直接落地，不绕弯子。