详解php 获取根目录：不同服务器环境下的代码实例。

发布日期： 2025-09-30 阅读量： 作者： admin

今天搞代码的时候，又碰到个老生常谈的问题了——怎么拿到 PHP 项目的根目录。每次搭新项目或者维护老项目，路径这事儿总得捋一捋。

我的摸索过程

我就想着用最常见的那几个办法试试。脑子里第一个蹦出来的就是那个 $_SERVER['DOCUMENT_ROOT']。想着这玩意儿应该是直接指向网站根目录的？

然后我就在我本地环境试了下，写了个简单的 PHP 文件，里面就 `echo $_SERVER['DOCUMENT_ROOT'];`。跑了一下，确实输出了我本地 Apache 配置的那个网站根目录，比如 `D:/www/` 这样的。

但转念一想，不对。有时候我的项目可能放在网站根目录下的一个子目录里，比如 `D:/www/myproject/`。如果我用 `$_SERVER['DOCUMENT_ROOT']`，拿到的还是 `D:/www/`，并不是我项目实际的根 `myproject` 这一层。而且如果是在命令行（CLI）模式下跑 PHP 脚本，这个 `$_SERVER['DOCUMENT_ROOT']` 好像就不怎么靠谱了，有时候甚至会没定义。

那这个不行，就得换个思路。

换个法子试试

我又琢磨，PHP 不是提供了些魔术常量嘛像 __FILE__ 和 __DIR__ 这种。`__FILE__` 能拿到当前这个 PHP 文件自己的完整路径，带文件名。`__DIR__` （PHP 5.3+ 才有的）更方便，直接拿到当前文件所在的目录路径。

我想，如果我在项目的一个固定位置的文件里，比如入口文件 `*` 或者一个核心的配置文件 `*` 里用 `__DIR__`，不就能得到这个文件所在的目录了吗？

假设我的项目结构是这样的：

myproject/
public/
* (入口文件)
app/
config/
*
vendor/

如果我在 `public/*` 里用 `echo __DIR__;`，那得到的就是 `.../myproject/public` 这个路径。这还不是项目根目录 `myproject`。

这时候，PHP 的 `dirname()` 函数就派上用场了。它可以返回路径中的父目录。那我在 `public/*` 里用 `dirname(__DIR__)`，不就刚好拿到上一层的路径 `.../myproject` 了吗？这就对了！

我就实践了一下，在我的入口文件 `public/*` 的开头加上了这么一句：

// 假设这是 public/* 文件的内容
// 计算项目根目录
$projectRoot = dirname(__DIR__);

然后我就可以用 `$projectRoot` 这个变量来拼接其他路径了，比如加载 `app` 目录下的文件啥的。`__DIR__` 这玩意儿比较不管你是通过 Web 服务器访问，还是在命令行里执行，它指的都是当前文件所在的真实目录，比较稳定。

最终的选择：定义常量

光是算出来还不够方便，每次用都得传这个变量或者重新算一遍也麻烦。很多框架都是在启动的时候就把这个根目录算然后定义成一个全局常量。

我也学着这么干，觉得这法子挺就在入口文件或者一个 bootstrap 文件（项目启动引导文件）里，把算好的路径用 `define()` 定义成一个常量，比如叫 BASE_PATH 或者 ROOT_PATH。

// 比如在 public/* 或者 * 里
define('ROOT_PATH', dirname(__DIR__));

这样一来，在项目的任何地方，我只要用 `ROOT_PATH` 这个常量就行了，非常方便，也保证了路径的一致性。比如要包含一个配置文件：

require ROOT_PATH . '/config/*';

这样写起来就清晰多了，维护起来也容易。

总结一下

今天我实践下来，觉得获取 PHP 项目根目录，比较靠谱和通用的方法就是：

找一个项目中位置相对固定的文件，通常是入口文件（如 `public/*`）或者启动文件（如 `*`）。
在这个文件里，使用魔术常量 __DIR__ 获取该文件所在的目录。
根据这个文件相对于项目根目录的位置，使用一次或多次 dirname() 函数，往上回溯，得到真正的项目根目录路径。
用 define() 把这个路径定义成一个全局常量，方便项目各处调用。

就这么个过程。虽然是个基础操作，但每次捋清楚了，心里就踏实多了。记录下来，也算是给自己做个备忘。省得下次又得从头想一遍。

上一篇: php curl获取响应头完整指南，轻松掌握服务器返回的头部

详解php 获取根目录：不同服务器环境下的代码实例。

随便看看