本文讲解如何在 php 中正确使用 `require` 包含相对路径文件，重点解决因工作目录与脚本位置不一致导致的 “failed to open stream” 错误，并提供基于 `__dir__` 和 `dirname()` 的可靠路径构造方案。
在 PHP 开发中，require（或 include）语句的路径解析依赖于当前工作目录（current working directory），而非被包含文件（如 item_page.php）所在的物理目录。这是许多开发者踩坑的根本原因——尤其在使用轻量级本地服务器（如 VS Code 的 Five Server 扩展）时，其启动方式往往以项目根目录为工作目录，而非脚本所在目录。
从你的错误日志可明确看到：
PHP Warning: require(../nav_bar/nav_bar.php): Failed to open stream... in C:\Users\holli\OneDrive\Dokumente\onlineshop\source\main\item_page\item_page.php on line 8
说明 PHP 尝试从当前工作目录向上一级找 nav_bar/ 文件夹，但实际结构中 nav_bar 与 item_page 是同级子目录（均位于 source/main/ 下），因此 ../nav_bar/ 实际指向的是 source/ 目录，自然找不到。
你尝试过的绝对路径（如 C:\...\nav_bar.php）也失败，是因为 Windows 路径中的反斜杠 \ 在 PHP 字符串中需转义（应写为 \\ 或使用正斜杠 /），且硬编码绝对路径严重破坏项目可移植性，绝不推荐用于生产环境。
立即学习“PHP免费学习笔记（深入）”；
✅ 正确解法：始终基于脚本自身位置构建路径
PHP 提供了魔术常量 __DIR__（返回当前文件所在目录的绝对路径），配合 dirname() 可安全向上跳转。根据你的目录结构：
onlineshop/
└── source/
└── main/
├── item_page/
│ └── item_page.php ← 当前执行脚本
└── nav_bar/
└── nav_bar.php ← 目标文件item_page.php 与 nav_bar.php 的共同父目录是 source/main/，因此应先跳到 main/，再进入 nav_bar/：
// ✅ 推荐写法：清晰、跨平台、可移植 require __DIR__ . '/../nav_bar/nav_bar.php';
⚠️ 注意：__DIR__ 返回的是 item_page.php 所在目录（即 .../source/main/item_page），../nav_bar/ 即相对于该目录向上一层进入 main/，再进入 nav_bar/ —— 完全匹配实际路径。
其他等效写法（按推荐度排序）：
// 方案2：显式用 dirname() 向上两级（更易读）
require dirname(__DIR__) . '/nav_bar/nav_bar.php';
// 方案3：若未来结构调整，可封装为常量（推荐大型项目）
define('ROOT_DIR', dirname(dirname(__DIR__)));
require ROOT_DIR . '/main/nav_bar/nav_bar.php';? 额外建议：
- 避免使用 require "source\main\nav_bar\nav_bar.php" 这类相对路径：它依赖工作目录，而 Five Server 等工具的工作目录不可控；
- 开发时可用 echo __DIR__; die(); 快速验证当前脚本路径；
- 生产环境建议统一入口（如 index.php），通过自动加载器（PSR-4）管理依赖，而非手动 require。
掌握 __DIR__ + 相对路径的组合，就能彻底告别 “No such file or directory” 错误——路径从此不再靠猜，而是由代码精确控制。
