部署Web主机后PHP opendir报目录不存在错误如何解决

核心问题是代码中使用了依赖PHP运行时工作目录的相对路径，不同环境下工作目录不一致导致路径解析失败：

• 本地开发环境中，Web服务器配置的PHP运行工作目录和写相对路径时的预期层级完全匹配，因此../../data/chapters/可以正确定位到目标目录，文件操作正常
• 部署到虚拟主机后，服务器的Web服务配置、路由规则和本地存在差异，PHP进程的运行工作目录发生变化，../../跳转的实际层级不符合预期，最终找不到对应slug命名的章节目录
• 第一个报错触发后，opendir()会返回布尔值false而非合法的目录句柄资源，后续readdir()接收false作为入参，就触发了第二个参数类型错误的警告
• 报错明确提示No such file or directory，说明当前阶段核心矛盾是路径解析错误，而非目录权限问题（权限问题会抛出Permission denied类报错）。

1. 废弃不可靠的相对路径写法，所有文件系统操作统一使用__DIR__魔术常量拼接绝对路径。__DIR__会固定返回当前代码文件所在的物理目录路径，不受PHP运行工作目录、路由规则的影响，跨环境一致性极强。
2. 增加目录存在性校验，避免目录不存在时直接调用opendir抛出警告，同时补全目录句柄关闭逻辑，修正后的代码如下：

$files = array();
// 以当前chapter.req.php文件所在目录为基准，拼接目标目录绝对路径
$chapterDir = __DIR__ . "/../../data/chapters/" . $chapter["slug"];

// 先校验目录是否存在且可读
if (is_dir($chapterDir) && is_readable($chapterDir)) {
    $dir = opendir($chapterDir);
    while(false != ($file = readdir($dir))) {
        if(($file != ".") and ($file != "..") and ($file != "index.php")) { 
            $files[] = $file;
        }
    }
    closedir($dir); // 操作完成后关闭目录句柄
} else {
    // 按需处理目录不存在的场景，比如自动创建目录、记录错误日志等
    // mkdir($chapterDir, 0755, true);
}

3. 路径校验通过后，额外确认服务器上data、chapters目录及子目录的权限，确保PHP运行用户对目录有读、写、执行权限，避免后续新增、编辑文件时触发权限错误。

• 项目中所有涉及文件读写、目录操作的路径，都要避免直接写./、../开头的相对路径，统一用__DIR__拼接绝对路径，从根源上规避跨环境路径不一致问题
• 调用文件系统操作函数前，优先做目标路径的存在性、可读性/可写性校验，不要直接传入路径执行操作，减少不必要的警告报错。

内容的提问来源于stack exchange，提问作者Komikbro Doy