本文介绍如何通过 php 的 `__dir__` 魔术常量构建稳定、可移植的文件包含路径，替代易出错的相对路径（如 `../`），从而提升项目可维护性与健壮性。
在 PHP 项目中，频繁使用 require_once('includes/afile.php') 或 require_once('../classes/aclass.php') 这类相对路径虽能运行，但存在明显缺陷：一旦文件位置变动（如将 afile.php 移至 includes/v1/），所有依赖它的相对路径均需手动更新，极易遗漏并引发 failed to open stream 错误。更严重的是，相对路径的解析基准是当前工作目录（getcwd()），而非文件所在目录——这意味着在 CLI 环境或被其他脚本 include 时，路径可能意外失效。
✅ 推荐方案：始终基于 __DIR__ 构建绝对路径
__DIR__ 是 PHP 内置魔术常量，返回当前 PHP 文件所在目录的绝对路径（不含尾部斜杠），且不受执行上下文影响，安全可靠。其用法无需括号（因 require_once 是语言结构，非函数）：
// 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'; // ✅ 同目录下直接引用
⚠️ 注意事项：
- 禁止混用 define("ROOT_DIR", __DIR__) 全局常量：虽看似便捷，但若项目存在多入口（如 admin/index.php 和 api/index.php），各入口的 __DIR__ 不同，全局 ROOT_DIR 将指向错误根目录，导致路径失效；
- 避免 $_SERVER['DOCUMENT_ROOT']：仅适用于 Web 请求，CLI 环境下不可用，且不适用于子目录部署；
- 统一风格：所有 require_once 均采用 __DIR__ . '/path/to/file.php' 格式，杜绝裸字符串路径；
- 路径分隔符兼容性：__DIR__ 返回系统原生路径（Windows 为 \），但 PHP 自动兼容 /，因此统一使用 / 更简洁安全（如 __DIR__ . '/classes/aclass.php'）。
? 进阶建议：
对于大型项目，可封装路径工具函数（如 app_path('classes/aclass.php')），内部统一基于主入口的 __DIR__ 计算，兼顾灵活性与一致性。但对绝大多数场景，直接使用 __DIR__ 已足够稳健、高效且无额外依赖。
总结：放弃相对路径，拥抱 __DIR__ —— 它让每一次 require_once 都精准、可预测、可迁移。
