当 a.php include b.php,而 b.php 再 include c.php 时,b.php 中的相对路径是相对于 a.php 所在目录 解析的,而非 b.php 自身目录。这导致多层嵌套、多入口引用同一文件时路径极易出错。
project/
├── a.php # 入口 1
├── d/
│ └── d.php # 共享底层库
├── b/
│ └── b.php # 入口 2
└── c/
└── c.php # 中间层,被 a/b 共同引用
<?php
$file = 'a.php';
require 'c/c.php'; // 引用 c.php
<?php
echo "c.php loaded by $file\n";
require '../d/d.php'; // ❌ 相对 a.php 正确,但相对 c.php 错误!
<?php
$file = 'b.php';
require '../c/c.php'; // 引用同一个 c.php
a.php:c.php 中 require '../d/d.php' 实际解析为 project/d/d.php ✅b/b.php:c.php 中同一行解析为 project/b/d/d.php ❌ 文件不存在在 被包含文件内部 使用 __DIR__(PHP 5.3+ 等价于 dirname(__FILE__))作为基准路径,彻底解耦入口脚本位置。
<?php
echo "c.php loaded by $file\n";
// 以 c.php 所在目录为基准,向上一级找 d 目录
require __DIR__ . '/../d/d.php'; // 无论谁 include 我,路径永远正确
__FILE__ 是编译时常量,表示当前文件的绝对路径dirname() 取其目录手动管理 require 路径已过时。现代 PHP 项目应:
composer dump-autoload 生成 vendor/autoload.phprequire_once __DIR__ . '/vendor/autoload.php';use Vendor\Package\ClassName; 使用类,无需任何 requiredefine('ROOT', __DIR__ . '/../');require ROOT . 'path/to/file.php';| 常量/函数 | 含义 | 推荐度 |
|---|---|---|
| __FILE__ | 当前文件绝对路径(含文件名) | ✅ 基础 |
| __DIR__ | 当前文件目录(PHP 5.3+) | ✅ 首选 |
| dirname(__FILE__) | 等价 __DIR__ | 兼容旧版本 |
| getcwd() | 当前工作目录(入口脚本目录) | ❌ 不可靠 |
| $_SERVER['SCRIPT_FILENAME'] | 入口脚本绝对路径 | ❌ 同 getcwd |
“以我为准,管你谁引用我” ——
__DIR__是 PHP 文件包含路径解析的唯一真理。现代项目请直接拥抱 Composer PSR-4 自动加载,彻底告别路径烦恼。