PHP 中相对路径包含失败的根源与解决方案-php教程-PHP中文网

PHP 中相对路径包含失败的根源与解决方案

PHP 文件包含失败常因当前工作目录（CWD）与脚本所在目录不一致导致，require_once("../views/init.php") 会基于 index.php 的执行路径解析，而非 models/init.php 的物理位置；使用 __DIR__ 或预定义应用根路径可彻底解决此问题。

php 文件包含失败常因当前工作目录（cwd）与脚本所在目录不一致导致，`require_once("../views/init.php")` 会基于 `index.php` 的执行路径解析，而非 `models/init.php` 的物理位置；使用 `__dir__` 或预定义应用根路径可彻底解决此问题。

在你描述的项目结构中，backend/models/init.php 尝试通过 require_once("../views/init.php") 加载视图层初始化文件，却报错“failed to open stream”，根本原因在于：PHP 的 require_once 和 include 等语句解析相对路径时，依据的是 脚本执行时的当前工作目录（Current Working Directory, CWD），而非 被包含文件（即 models/init.php）自身所在的目录。

默认情况下，当你通过浏览器访问 http://localhost/index.php 时，PHP 是以 index.php 所在目录（即项目根目录）为 CWD 启动执行的。因此，即使 models/init.php 内写了 ../views/init.php，PHP 实际仍从项目根目录出发向上跳一级（这已超出项目范围），再进入 views/ —— 显然路径错误。

✅ 正确做法：始终基于 当前文件的绝对目录 构建路径。推荐使用魔术常量 __DIR__（返回当前 PHP 文件所在目录的绝对路径，不含尾部斜杠）：

// backend/models/init.php 中正确写法
require_once __DIR__ . '/../views/init.php';

__DIR__ 在 models/init.php 中返回 C:\wamp64\www\s_top_navbar\backend\models，拼接 '../views/init.php' 后得到 C:\wamp64\www\s_top_navbar\backend\views\init.php，精准定位目标文件。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

? 进阶建议：统一应用根路径管理
为提升可维护性与跨环境兼容性，建议在入口文件 index.php 顶部定义一个全局应用根常量：

// index.php（首行附近）
define('APP_ROOT', dirname(__DIR__) . '/'); // 或 realpath(dirname(__FILE__)) . '/'
// 注意：dirname(__DIR__) = 项目根目录（因 __DIR__ 是 index.php 所在目录）

随后所有包含均可基于 APP_ROOT 构建：

// backend/models/init.php
require_once APP_ROOT . 'backend/views/init.php';

// includes/header.php
require_once APP_ROOT . 'backend/models/init.php';

? 注意事项：