PHP遍历文件夹所有文件的实现方法

本文深入解析了PHP中遍历文件夹（包括单层与递归）的多种实用方法，重点对比scandir()、glob()、RecursiveDirectoryIterator及opendir/readdir等方案的性能、安全性与适用场景，强调剔除`.`和`..`、防范软链接循环、预检目录可读性、合理处理路径分隔符与符号链接等关键细节，并指出大目录过滤推荐glob()、递归推荐手写轻量函数而非依赖复杂内置迭代器，最后提醒日志埋点比盲目try/catch更能定位真实卡点——帮你避开90%线上遍历故障的隐形陷阱。

用 scandir() 最快扫出所有文件，但默认包含 . 和 ..

直接调 scandir() 能拿到文件夹下所有条目，但它一定会返回 .（当前目录）和 ..（父目录），不剔除就会在后续处理里报错或跳过真实文件。

• 用 array_diff() 剔除：array_diff(scandir($path), ['.', '..'])
• 别用 foreach 里手动 continue 判字符串——容易漏掉其他隐藏文件（比如 .gitignore）
• scandir() 返回的是无序列表，如需按字母/时间排序，得额外调 sort() 或 usort()

递归遍历必须自己写函数，PHP 没有内置「深度遍历」开关

scandir() 只扫一层，要进子目录就得手动判断类型、再调自己。PHP 的 RecursiveDirectoryIterator 虽然能递归，但对象接口重、容错差，一不小心就抛 UnexpectedValueException。

• 推荐手写轻量递归：先 is_dir() 再 scandir()，遇到子目录就 call 自己
• 注意避免无限递归：检查 is_link() 防软链接循环，尤其是 Linux 环境下可能有 /proc/self 这类自指路径
• 不要在递归里反复拼接路径字符串，用 realpath() 或 dirname() + basename() 更稳

遇到权限不足或符号链接时，opendir() 会静默失败

scandir() 在没权限的目录里会返回 false，但不报错；而 opendir() + readdir() 方式更可控，能配合 @ 抑制警告，再用 is_readable() 提前守门。

• 先 if (!is_readable($path)) { return []; }，比硬闯安全得多
• 对符号链接，默认不跟随，要用 is_dir($path) && !is_link($path) 显式排除，否则 scandir() 可能崩在挂载点或损坏链接上
• Windows 下路径分隔符用 / 完全没问题，别硬切 \\，PHP 内部自动兼容

大目录下用 glob() 替代 scandir() 更省内存

当只要某类文件（比如所有 .php），glob($path . '/*.php') 比先扫全量再 preg_match() 过滤快得多，且 PHP 内部用系统 readdir() 实现，不常驻内存。

• glob() 不支持递归，想搜子目录得加 GLOB_BRACE 和 **（PHP 7.1+），但部分旧服务器禁用 **
• 路径里含变量时务必 escapeshellarg()？不用——glob() 不走 shell，但变量本身得确保是合法路径，建议用 realpath() 校验
• 空结果返回空数组，不是 false，别用 === false 判错

实际跑起来最常卡住的地方，其实是没预判到某些子目录不可读、或软链接指向了不存在的位置——这些不会立刻报错，但会让递归中途断掉，还查不出原因。留个 error_log() 打点日志比加 try/catch 更管用。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~