opendir()不是独立可用函数，必须与readdir()、closedir()配合使用，返回资源类型，不可直接echo或json_encode；失败主因是权限、符号链接或目录状态问题，需先用is_dir()和is_readable()校验。
直接说结论：opendir() 不是独立可用的函数，它必须和 readdir()、closedir() 配合使用，且返回值是资源类型（resource），不能直接 echo 或 json_encode。
opendir() 返回 false 的常见原因
不是路径写错了，而是权限、符号链接或目录状态问题：
-
is_dir($path)必须先调用——很多失败是因为传入的是文件、不存在路径，或 PHP 进程无权读取该目录（比如/root或某些 Docker 容器内挂载点） - 路径末尾带斜杠（
"logs/"）或不带（"logs"）不影响，但若路径含中文、空格、特殊字符，需确保 PHP 文件编码为 UTF-8 且 Web 服务器（如 Nginx/Apache）未做 URL 解码干扰 - FTP 路径（如
"ftp://user:pass@host/dir"）仅在 PHP 5.0+ 启用ftp封装协议时才有效；默认禁用，需检查php.ini中allow_url_fopen = On且extension=ftp已加载 - 错误提示是
E_WARNING，不是异常，所以try/catch捕获不到；要用@opendir()屏蔽，或提前用is_dir()+is_readable()双检
readdir() 循环里为什么漏掉 "0" 文件？
因为 readdir() 在读到名为 "0" 的文件或目录时会返回字符串 "0"，而 while ($file = readdir($dir)) 会把它当成 false 终止循环——PHP 把 "0" 当作 falsy 值。
正确写法必须用严格比较：
$dir = opendir('./data');
while (($file = readdir($dir)) !== false) {
if ($file === '.' || $file === '..') continue;
echo $file . "\n";
}
closedir($dir);
- 永远用
!== false，不用!= false或直接赋值判断 - 跳过
"."和".."是硬性要求，否则可能陷入无限递归或报错 - 如果要过滤隐藏文件（以
.开头），加一行if (str_starts_with($file, '.')) continue;（PHP 8.0+），旧版本用substr($file, 0, 1) === '.'
opendir() 和 scandir()、glob() 的实际取舍
别为了“底层”硬用 opendir()。三者差异很实在：
-
scandir($path)一次性返回全部文件名数组，自动排除"."/".."，支持排序参数，适合小目录（ -
glob($pattern)支持通配符（如"*.log"），天然过滤，比opendir+readdir+fnmatch简洁得多；但不支持递归，也不返回文件属性（如大小、时间） -
opendir()唯一不可替代的场景：需要逐个检查每个条目是否为目录（is_dir($path.'/'.$file)）并递归进入，且目录极大（如百万级日志文件），避免一次性加载进内存；或者需要配合rewinddir()多次遍历同一目录
多数情况下，先写 scandir()，卡顿了再换 opendir() —— 过早优化真会踩坑。
真正容易被忽略的是：opendir 打开的资源不自动释放，忘记 closedir() 会导致文件描述符泄漏，尤其在长生命周期脚本（如 CLI 守护进程）中，撑爆系统限制后整个 PHP 进程会拒绝打开任何新目录或文件。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
