php 获取项目根目录有哪些方法？这几种简单又好用！

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

今天就来唠唠我在搞 php 项目时，是怎么拿到项目根目录这事的儿。这玩意儿，说简单也简单，说麻烦也确实能绕进去。

刚开始弄的时候，我也挺懵的。项目里头文件到处引用，有时候图片路径不对了，有时候配置文件找不着了，多半就是这个路径没搞对。最开始图省事，直接用相对路径，比如 `../` 这种，或者干脆写死绝对路径。但这法子太蠢了，代码挪个地方，或者项目部署到服务器上，路径一变，立马完蛋，到处报错，改起来头都大。

后来我就琢磨，得找个动态获取项目根目录的方法，这样不管项目在哪儿，都能找到正确的路径。上网搜了搜，看到有人说用 `$_SERVER['DOCUMENT_ROOT']`。试了下，在某些环境下确实能拿到网站的根目录。但问题来了，有时候我的项目可能只是网站目录下的一个子目录，或者我是在命令行下跑脚本，这时候 `$_SERVER['DOCUMENT_ROOT']` 就可能不是我想要的那个“项目根目录”了，甚至可能直接没这个值。所以感觉这玩意儿不太靠谱，得看环境。

接着我又发现了几个 PHP 自带的“魔术常量”，听名字挺唬人，就是预先定义好的常量。比如 `__FILE__`，它能告诉你当前这个 PHP 文件它自己的完整路径，带文件名。这有点意思，但还不是项目根目录，只是当前文件的位置。

然后，我又看到了 `__DIR__`。这个直接就拿到当前文件所在的文件夹路径，比 `__FILE__` 再用 `dirname()` 处理一下要方便。但问题和 `__FILE__` 一样，它拿到的是当前脚本文件所在的目录，如果我的脚本在项目的子目录里，比如 `app/controller/*`，那 `__DIR__` 拿到的就是 `app/controller` 这个目录，离项目根儿还差着两级。

怎么办？我就想，既然能拿到当前目录，那我往上退呗。用 `dirname()` 函数，它可以获取一个路径的上级目录。比如我在 `app/controller/*` 里用 `dirname(__DIR__)`，就能拿到 `app` 目录。再套一层 `dirname(dirname(__DIR__))`，不就拿到项目根目录了吗？

这法子好像可行，但感觉还是有点别扭。万一以后项目结构调整了，文件挪动了，这 `dirname()` 套几层就得跟着改，还是麻烦。而且每个文件里都这么写一遍，也挺啰嗦的。

我现在的搞法

搞来搞去，我觉得最稳妥的法子，还是得在项目里找个“基准点”。通常一个项目都会有个单一入口文件，比如放在根目录的 `*`，或者是框架的启动文件，比如 `public/*` 或者 `bootstrap/*` 之类的。这个文件的位置是相对固定的。

我就在这个启动文件里面下手。因为它最靠近项目根目录，甚至就直接在根目录。

情况一：如果启动文件就在项目根目录，比如 `*`。那在这个文件里，`__DIR__` 不就正好是项目根目录嘛简单明了。
情况二：如果启动文件在根目录下的某个文件夹里，比如 `public/*`。那在这个文件里，用 `dirname(__DIR__)`，就拿到了它爹，也就是项目根目录。

拿到这个路径后，为了方便整个项目使用，我通常会用 `define()` 定义一个常量，比如叫 `ROOT_PATH`。就像这样：

如果入口文件在根目录：

define('ROOT_PATH', __DIR__);

如果入口文件在根目录下的 `public` 目录：

define('ROOT_PATH', dirname(__DIR__));

把这行代码加到项目启动文件比较靠前的位置。这样，整个项目运行起来之后，随时随地都可以用 `ROOT_PATH` 这个常量来表示项目根目录了。

比如要包含根目录下的 `config/*` 文件：

require ROOT_PATH . '/config/*';

或者要获取 `storage/app/public` 目录的路径：

$storagePath = ROOT_PATH . '/storage/app/public';

这样搞，我觉得挺清晰，也挺稳。不管项目部署到哪台服务器，什么操作系统，只要保证入口文件的相对位置不变，这个 `ROOT_PATH` 就总是对的。维护起来也方便，关于根目录的定义就集中在一处。反正我实践下来，这个方法最省心，一直这么用着，没出过啥岔子。

上一篇: 阿贝云主机免费云服务器好用吗？速度快还稳定！

php 获取项目根目录有哪些方法？这几种简单又好用！

随便看看