PHP 中使用 require 包含文件时的路径问题详解_网络技术

PHP 中使用 require 包含文件时的路径问题详解

发布时间 - 2026-01-10 00:00:00 点击率：次

本文讲解如何在 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 提供了魔术常量 __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” 错误——路径从此不再靠猜，而是由代码精确控制。

# php # windows # 编码 # 工具 # ai # win # stream # vs code # echo # 常量 # 魔术常量 # include # require # die # Directory # 字符串 # 的是 # 而非 # 这是 # 是因为 # 就能 # 是由 # 找不到 # 这类 # 跳转 # 相对于

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：VS Code的“问题”面板：快速定位并修复代码错误

下一篇：VS Code活动栏(Activity Bar)的自定义与优

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：VS Code的“问题”面板：快速定位并修复代码错误

下一篇：VS Code活动栏(Activity Bar)的自定义与优