readdir 总返回 "." 和 ".." 是 POSIX 标准行为，因每个目录底层天然包含这两个特殊入口；PHP 忠实暴露原始结构，不隐藏、不过滤，需手动用严格比较（!==）过滤。
readdir 为什么总返回 "." 和 ".."
这是 POSIX 文件系统标准行为，不是 PHP 的 bug 或设计失误。每个目录在底层都天然包含两个特殊入口：.（当前目录）和 ..（父目录），readdir() 只是忠实地把它们读出来。Linux、macOS 甚至 Windows 的兼容层都如此实现，PHP 不做隐藏、不加过滤——它暴露的是原始目录结构。
手动过滤 "." 和 ".." 的正确写法
必须用严格比较，且不能依赖循环索引或硬编码键名。常见错误包括用 == 导致字符串 "0" 被误判为 false，或直接 unset($arr[0], $arr[1]) —— 目录为空、权限不足或挂载异常时，readdir() 返回顺序和数量可能变化，这种写法会漏掉真实文件或报错。
- ✅ 正确方式：在
while循环体内用!== false判定返回值，并立即检查$file !== '.' && $file !== '..' - ✅ 若需复用逻辑，可封装成匿名函数传给
CallbackFilterIterator，配合FilesystemIterator::SKIP_DOTS更简洁 - ⚠️ 避免用
in_array($file, ['.', '..'])而不加true参数——松散比较会让0 == '.'成立
scandir 和 readdir 在过滤上的关键差异
scandir() 返回完整数组，适合一次性过滤后重索引；readdir() 是流式逐条读取，更适合边读边判、内存敏感场景。但两者面对 . 和 .. 的语义完全一致，过滤逻辑也应保持统一。
-
scandir()后推荐用array_filter(..., function($x) { return !in_array($x, ['.', '..'], true); })，再跟array_values()重置键 -
readdir()必须配合opendir()使用，且循环条件必须写成false !== ($file = readdir($dh))，否则遇到文件名"0"会提前退出 - 两者都不自动跳过隐藏文件（如
.gitignore），如需排除，得额外加正则或substr($file, 0, 1) === '.'判断
容易被忽略的边界情况
很多人只在开发环境测试正常目录，上线后才发现问题：权限受限目录可能只返回 . 和 ..，空目录也如此；NFS 或容器挂载卷有时会返回乱序或重复项；Windows 下大小写不敏感，但 readdir() 返回的仍是原始大小写，strcasecmp 比较更稳妥。
- 务必在
opendir()后检查是否返回有效 resource，失败时readdir()会警告并返回false - 不要假设
.总是第一个——某些文件系统（如某些 FUSE 实现）不保证顺序 - 如果后续要拼路径做
is_file()，记得用realpath()或dirname(__FILE__) . '/' . $file，避免相对路径解析出错
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
