本文详解 php 中 `require_once` 路径管理的最佳实践，对比相对路径、`__dir__` 魔术常量与全局常量方案，推荐以 `__dir__` 为基础的绝对路径写法，避免因文件移动导致的路径失效问题，并纠正语言构造误用（如多余括号）。
在 PHP 项目中，依赖文件的加载路径看似简单，实则极易成为维护隐患。你当前采用的纯相对路径写法（如 '../classes/aclass.php'）虽能运行，但存在明显缺陷：路径基准依赖于当前工作目录（getcwd()），而非文件自身位置。这意味着一旦通过 CLI 运行、被其他脚本包含，或 Web 服务器配置变更，require_once 可能意外失败——尤其在 afile.php 被多个不同层级的入口调用时，../classes/aclass.php 的解析结果将不可预测。
✅ 正确做法：始终以当前文件所在目录为基准构建路径，使用 PHP 内置魔术常量 __DIR__（PHP 5.3+，等价于 dirname(__FILE__)）：
// main.php require_once __DIR__ . '/includes/afile.php'; // includes/afile.php require_once __DIR__ . '/../classes/aclass.php'; // classes/aclass.php require_once __DIR__ . '/bclass.php';
注意：require_once 是语言构造（language construct），不是函数，因此不应加括号。以下写法是错误的：
require_once('includes/afile.php'); // ❌ 语法虽允许，但违背规范，易引发混淆正确写法为：
require_once __DIR__ . '/includes/afile.php'; // ✅ 清晰、高效、符合 PHP 官方风格
⚠️ 关于你提出的 define("ROOT_DIR", __DIR__) 方案：
该方法逻辑可行，但存在两个关键问题：
- 作用域污染：ROOT_DIR 成为全局常量，若项目引入第三方库或后续模块也定义同名常量，将触发致命错误（Notice: Constant ROOT_DIR already defined）；
- 冗余与耦合：需在每个文件中确保 ROOT_DIR 已定义（例如通过 defined('ROOT_DIR') or die()），增加出错点；而 __DIR__ 无需声明、零成本、天然隔离。
? 进阶建议：统一项目根目录引用
若项目结构较深（如 src/, vendor/, public/ 分离），可在入口文件（如 public/index.php） 中定义一个只读、命名空间化的常量（推荐）或配置变量：
// public/index.php —— 唯一可信的入口
define('APP_ROOT', dirname(__DIR__)); // 指向项目根目录（含 src/, vendor/ 等）
require_once APP_ROOT . '/src/bootstrap.php';其余文件则基于自身 __DIR__ 或 APP_ROOT 构建路径，兼顾灵活性与健壮性。
? 总结最佳实践：
- ✅ 优先使用 __DIR__ + 字符串拼接，路径基准明确、无副作用；
- ✅ 禁用 require_once(...) 的括号形式，保持代码规范；
- ✅ 避免全局常量（如 ROOT_DIR），除非严格管控定义时机与命名；
- ✅ 入口文件可定义 APP_ROOT 等高层抽象，但非必需；
- ✅ 切勿依赖 ./ 或 ../ 相对路径——它们脆弱且语义模糊。
遵循以上原则，你的依赖加载将具备强可移植性：无论文件如何移动、项目如何部署，路径逻辑始终清晰可靠。
