PHP递归遍历目录方法详解
scandir递归需手动过滤'.','..'并校验权限，否则易无限递归或Permissiondenied；RecursiveIterator自动跳过点文件且更安全，但默认静默忽略不可读目录，性能上scandir略快但容错差。
scandir递归需手动过滤'.','..'并校验权限，否则易无限递归或Permission denied；RecursiveIterator自动跳过点文件且更安全，但默认静默忽略不可读目录，性能上scandir略快但容错差。
scandir 递归遍历目录时容易漏掉子目录或报错
直接用 scandir 做递归，必须手动过滤 . 和 ..，否则会无限递归或跳进上级目录。PHP 7.4+ 虽然加了 SCANDIR_SORT_NONE 选项，但不影响路径逻辑——它只控制排序，不解决递归边界问题。
常见错误现象：Warning: scandir(): Failed to open dir: Permission denied 或遍历结果里混入 ./config 这种相对路径，导致 is_dir() 判断失败。
- 每次调用
scandir后，用array_diff($files, ['.', '..'])清洗结果 - 拼接子路径时务必用
realpath($dir . DIRECTORY_SEPARATOR . $file)或至少$dir . '/' . $file（Windows 下DIRECTORY_SEPARATOR更稳妥） - 在进入子目录前，先用
is_dir()+is_readable()双重检查，避免权限错误中断流程
RecursiveIterator 实现更安全但要注意迭代器状态
RecursiveIterator 系列（比如 RecursiveDirectoryIterator + RecursiveIteratorIterator）本质是封装好的树形遍历器，不用手动处理 ./..，也不容易写错路径拼接。但它默认跳过不可读目录——不是报错，而是静默忽略，这点容易被当成“没遍历到”。
使用场景：需要稳定遍历、支持过滤、或后续要对接 FilterIterator 做条件筛选（比如只取 .php 文件）。
- 构造
RecursiveDirectoryIterator时传FilesystemIterator::SKIP_DOTS，比默认行为更明确 RecursiveIteratorIterator的第二个参数决定遍历深度，RecursiveIteratorIterator::SELF_FIRST是常用值；用LEAVES_ONLY会跳过目录本身，只返回文件- 迭代过程中不能随意调用
getChildren()并再次 foreach —— 它会破坏当前迭代器状态，导致跳过条目或Invalid argument supplied for foreach()
性能差异：scandir 递归 vs RecursiveIterator
小目录（<1000 个文件）两者差别不大；但目录嵌套深、单层文件多时，scandir 手动递归通常更快——因为没对象创建开销，且能按需跳过子目录。而 RecursiveIterator 在初始化时就会尝试读取所有层级的目录结构，遇到权限不足的目录会直接停止该分支，但前期仍做了不少无效探测。
兼容性影响：PHP 5.3+ 支持 RecursiveIterator，但某些旧环境（如部分共享主机）禁用了 RecursiveDirectoryIterator 的 glob:// 尝试逻辑，表现为无法进入某些符号链接目录。
- 如果只需要列出路径，不用元信息（修改时间、大小等），
scandir+foreach组合更轻量 - 若需获取文件
mtime、size或做isLink()判断，RecursiveDirectoryIterator返回的SplFileInfo对象更省事 - 注意
RecursiveIteratorIterator默认不抛异常，要用setFlags(RecursiveIteratorIterator::CATCH_GET_CHILD)才能在子目录出错时继续主循环
实际用例中容易忽略的路径编码和符号链接处理
中文路径在 scandir 下可能返回乱码（尤其 Windows + GBK 环境），而 RecursiveDirectoryIterator 内部用 UTF-8 处理，表现更一致。但两者对符号链接都默认跟随——也就是说，is_dir() 返回 true 的可能是软链指向的目录，不是原始路径本身。
这会导致两个问题：一是遍历路径重复（软链指向已遍历过的目录），二是统计磁盘占用时误算。
- 用
lstat()替代stat()或is_dir()来判断是否为符号链接，再决定是否跳过 - 记录已访问的
realpath()（非原始路径），防止软链循环引用 - PHP 8.0+ 可用
RecursiveDirectoryIterator::FOLLOW_SYMLINKS构造参数控制是否跟随，之前版本只能靠is_link()+ 手动跳过
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
