__DIR__ 等价于 dirname(__FILE__)，但更高效、编译期解析且不受 chdir() 影响；二者在软链接下均返回物理路径，需显式定义 APP_ROOT 获取逻辑根目录；拼接路径须补 /，慎用 realpath()，统一转 / 避免反斜杠问题，勿依赖 $_SERVER['DOCUMENT_ROOT']。
PHP中dirname(__FILE__)和__DIR__的区别与误用
很多路径错误其实不是路径本身写错了，而是获取当前文件所在目录的方式不一致导致的。PHP 5.3+ 推荐用 __DIR__，它等价于 dirname(__FILE__)，但更简洁、无函数调用开销，且在编译期解析，不会受chdir()影响。
常见误用：dirname(__FILE__) . '/../config' 在 symlink 环境下可能返回真实路径而非符号链接路径，而 __DIR__ 同样如此——这点常被忽略。
- 如果项目部署用了软链接（比如
/var/www/app → /srv/releases/20240501），__DIR__返回的是真实物理路径，不是你期望的“项目根目录” - 想获得“逻辑项目根目录”，建议显式定义常量：
define('APP_ROOT', dirname(dirname(__DIR__)));，再逐层向上推，比靠猜更可靠 - 避免拼接时漏掉
/：写成__DIR__ . 'config'会变成/path/to/fileconfig，必须写成__DIR__ . '/config'
用realpath()前先确认是否真需要“真实路径”
realpath() 会解析所有 ..、. 和符号链接，返回绝对路径。但它在某些场景下反而破坏预期——比如你依赖相对路径做动态模块加载，或调试时想看“代码里写的路径长什么样”。
典型问题：realpath('../vendor/autoload.php') 在 CLI 下工作正常，但在 Web 服务器（如 Apache 的 DocumentRoot 切换后）可能因工作目录不同而失败，报 realpath(): open_basedir restriction 或直接返回 false。
立即学习“PHP免费学习笔记（深入）”；
- 检查返回值：
$path = realpath($rel); if ($path === false) { throw new RuntimeException("Path invalid: $rel"); } - 若只是为安全拼接，优先用
strtr($rel, ['\' => '/'])清理反斜杠，再用__DIR__ . '/' . ltrim($rel, '/')拼接，不触发磁盘 I/O - 仅当需校验路径是否存在且必须是真实路径时才用
realpath()，例如日志写入前确认目录可写
Windows 和 Linux 路径分隔符混用导致file_exists()失败
PHP 内部多数函数（如 file_exists()、is_dir()、include）能自动处理 和 /，但部分扩展（如某些版本的 phar 或自定义 autoloader）对反斜杠敏感，尤其在 Windows 上用 __DIR__ 拿到带 的路径后直接拼接，传给第三方库就出错。
错误现象：Warning: include(): Failed opening 'C:projectsrc/../lib/helper.php'，实际文件存在，但路径含 .. 被某些解析器误判。
- 统一转为正斜杠：
str_replace('\', '/', $path)，这是最轻量且兼容性最好的做法 - 不要依赖
DIRECTORY_SEPARATOR构造路径——它让代码变复杂，且 Web 服务端几乎全是/，硬切反而增加出错概率 - 检查 Composer autoload 配置中的
psr-4映射路径，确保不含 Windows 风格分隔符（src\应为src/）
Apache/Nginx 下$_SERVER['DOCUMENT_ROOT']不可靠，别拿它当项目根
很多人习惯用 $_SERVER['DOCUMENT_ROOT'] . '/app/config' 定位配置，但这个值由 Web 服务器配置决定，不是 PHP 自身上下文。一旦启用子目录部署、别名（Alias）、多站点或 CLI 运行，DOCUMENT_ROOT 就失效甚至未定义。
错误示例：在 Laravel 的 Artisan 命令里读 $_SERVER['DOCUMENT_ROOT']，结果为 null，后续路径全崩。
- CLI 环境下
$_SERVER不包含DOCUMENT_ROOT，应改用__DIR__向上推导，或通过环境变量（如APP_BASE_PATH）注入 - Web 环境下，若项目不在 Web 根目录（比如部署在
https://example.com/myapp/），DOCUMENT_ROOT指向的是/var/www/html，不是/var/www/html/myapp - 真正稳定的锚点只有
__DIR__（当前文件位置）和已知入口文件（如public/index.php）的位置
