readdir返回false的常见原因：句柄无效或已读完；opendir失败（权限不足、路径错误、中文/空格未转义）导致句柄为空；循环末尾继续调用属正常行为。
readdir 读取目录内容时返回 false 的常见原因
readdir 本身不报错，但常返回 false，多数是因为目录句柄无效或已到末尾。关键不是“为什么没数据”，而是“句柄是否还活着”：
- 必须先用
opendir成功打开目录，否则readdir($handle)直接返回false - 重复调用
readdir到末尾后，继续调用仍返回false，不是错误，是正常行为 - 目录权限不足（如 Web 服务器用户无法读取）会导致
opendir失败，进而让后续readdir拿到null或未定义句柄 - Windows 下路径含中文、空格或
\反斜杠时，若未正确转义或使用双引号包裹，opendir可能静默失败
readdir 循环中跳过 . 和 .. 的标准写法
PHP 不自动过滤当前目录（.）和父目录（..），必须手动判断——这是最常漏掉的一步，导致逻辑误处理：
$dh = opendir('/path/to/dir');
while (($file = readdir($dh)) !== false) {
if ($file === '.' || $file === '..') {
continue;
}
echo $file . "\n";
}
closedir($dh);
注意：=== false 是严格比较，避免把文件名 "0" 或空字符串误判为结束；continue 后直接进入下一轮，不建议用 if (!in_array(...)) { ... } 包裹整个逻辑块，易嵌套过深。
readdir 和 scandir 性能与适用场景差异
两者都能列目录，但底层行为不同：
立即学习“PHP免费学习笔记（深入）”；
-
readdir是流式读取，内存占用恒定，适合大目录（如含数万文件的日志目录），但必须自己管理循环和过滤 -
scandir一次性读入全部文件名数组，返回前已按字母序排序，适合小目录或需要排序/计数的场景，但会吃光内存（比如 10 万文件可能占上百 MB） -
readdir不保证顺序（取决于文件系统），若需排序，应在循环结束后用sort($files)或改用scandir - PHP 8.1+ 中
scandir支持SCANDIR_SORT_NONE参数跳过默认排序，可略微提速，但仍是一次性加载
readdir 在 CLI 和 Web 环境下的路径陷阱
同一段代码在命令行跑通，放到 Web 中却 opendir 失败，大概率是工作目录或权限问题：
- CLI 下当前路径通常是脚本所在目录；Web 下（如 Apache + mod_php）当前路径一般是 Web 根目录（如
/var/www/html），不是脚本路径 - 应优先用绝对路径：用
__DIR__ . '/data'替代'./data'，避免相对路径歧义 - Web 服务器用户（如
www-data或apache）可能无权访问你本地开发时能读的路径（例如/home/user/files），需检查ls -ld /home/user权限位 - 容器或云环境（如 Docker、Laravel Vapor）中，挂载路径、SELinux 策略、只读文件系统都可能导致
opendir静默失败，建议加error_log("opendir: " . var_export($dh, true));辅助排查
真正卡住的地方往往不是 readdir 本身，而是句柄从哪来、在哪执行、有没有权限看——这些比循环写法更值得花时间确认。
