本文详解 php 中 require_once 路径管理的最佳实践，推荐使用 `__dir__` 魔术常量构建绝对路径，避免依赖当前工作目录，提升代码可移植性与维护性。
在 PHP 项目中，文件包含路径（如 require_once）若仅依赖相对路径（如 '../classes/aclass.php'），极易因目录结构调整、脚本执行位置变化或 CLI/Web 环境差异而失效。你当前的写法虽能运行，但存在明显隐患：
- require_once('../classes/aclass.php') 依赖 afile.php 的所在目录作为基准，一旦 afile.php 被移动，该路径即失效；
- require_once('bclass.php') 更危险——它基于 PHP 的 include_path 或当前工作目录（getcwd()），而非文件自身位置，极易在 CLI 运行或子目录访问时出错；
- 全局常量 ROOT_DIR 方案（如 define('ROOT_DIR', __DIR__)）虽可行，但需手动传播、易被覆盖、不支持多入口场景，且违反“单一职责”原则。
✅ 最佳实践：始终使用 __DIR__ 构建从当前文件出发的绝对路径
__DIR__ 是 PHP 内置魔术常量，返回当前文件所在的绝对目录路径（不含尾部斜杠），与执行入口无关，稳定可靠：
// main.php require_once __DIR__ . '/includes/afile.php'; // includes/afile.php require_once __DIR__ . '/../classes/aclass.php'; // ✅ 从 afile.php 所在目录向上找 classes/ // classes/aclass.php require_once __DIR__ . '/bclass.php'; // ✅ 同目录下直接引用，清晰且健壮
? 关键优势：
- 零耦合：每个 require_once 都只依赖自身文件位置，移动任意文件时，只需修改其内部引用路径（通常仅需调整 __DIR__ 后的相对部分）；
- 环境无关：无论通过 Web 服务器、CLI 还是单元测试运行，__DIR__ 始终指向文件物理位置；
- 无需全局状态：避免 define() 带来的命名污染、作用域限制和初始化顺序问题；
- 语义明确：__DIR__ . '/path' 直观表达“从此文件所在目录出发”，比 ROOT_DIR 更精准（ROOT_DIR 实际应为项目根目录，但 __DIR__ 在 main.php 中才是根，而在 afile.php 中就不是）。
⚠️ 注意事项：
- require_once 是语言构造（language construct），不应加括号：写成 require_once __DIR__ . '/file.php';，而非 require_once(__DIR__ . '/file.php');（后者虽兼容，但违背规范，且可能掩盖错误）；
- 避免拼接路径时遗漏斜杠：__DIR__ . 'sub/file.php' 错误（缺少 /），应为 __DIR__ . '/sub/file.php'；
- 对于大型项目，建议统一入口（如 public/index.php）并定义 APP_ROOT 常量（基于 __DIR__ 向上定位），再配合自动加载器（PSR-4）替代大量 require_once。
总结：放弃脆弱的相对路径和易出错的全局常量，拥抱 __DIR__ —— 它是 PHP 提供的、最轻量、最可靠、最符合直觉的路径基石。
