phpEnv如何修改PHP doc_root phpEnv文档根目录-php教程-PHP中文网

应修改 apache 的 documentroot 和 directory 路径而非 php.ini 中的 doc_root，因 phpenv 使用模块或 fpm 模式使 doc_root 失效；需编辑 vhosts.conf 中 virtualhost 段的两处路径并重启 apache 验证。

phpenv如何修改php doc_root phpenv文档根目录

phpEnv 本身不直接暴露 doc_root 配置项供用户修改——它压根没用这个 PHP CGI 模式下的参数。你真正要改的，是 Apache（或 Nginx）的 DocumentRoot，以及对应虚拟主机的配置路径。

为什么改不了 phpEnv 的 doc_root？

doc_root 是 PHP CGI 模式下用于限制脚本执行范围的安全机制，而 phpEnv 默认使用的是 Apache 模块（libphp）或 FPM 方式运行 PHP，此时 doc_root 被忽略，实际生效的是 Web 服务器的文档根目录。

你在 phpEnv 界面里看到的“网站”列表，本质是 Apache 的 VirtualHost 配置
phpEnv 启动 Apache 后，所有请求由 DocumentRoot 和 <directory></directory> 共同决定文件能否被访问和执行
强行在 php.ini 里写 doc_root = /xxx 对模块模式无效，Apache 日志里可能报 PHP Warning: Directive 'doc_root' is deprecated

phpEnv 中正确修改文档根目录的路径

不要去动 php.ini，直接改 Apache 的虚拟主机配置文件：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

打开 phpEnv 安装目录 → Apache\conf\extra\vhosts.conf（Windows）或 etc/extra/vhosts.conf（macOS/Linux）

找到你要修改的站点段，例如：

<virtualhost>
    ServerName www.tp.com
    DocumentRoot "C:/phpenv/www/www.tp.com"
    <directory>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </directory></virtualhost>

把两处路径都改成你的新目录，比如 "D:/myproject"，注意保持双引号、斜杠方向（Windows 用正斜杠或双反斜杠均可）
保存后，在 phpEnv 界面点击「重启 Apache」，不是「重启服务」按钮（后者可能只重载 PHP-FPM）

验证是否生效的最快方式

别信配置文件写了就对了，立刻验证：

在你刚设的新 DocumentRoot 目录下放一个 test.php，内容为：

<?php echo '✅ Root OK: ' . $_SERVER['DOCUMENT_ROOT'] . '<br>';
echo '? File: ' . __FILE__;

浏览器访问 http://www.tp.com/test.php，输出的 $_SERVER['DOCUMENT_ROOT'] 必须和你配置的一致
如果返回 403，检查 <directory></directory> 块里的 Require all granted 是否漏写或拼错
如果返回 404，确认 Apache 是否真的加载了 vhosts.conf（看 phpEnv 日志里有没有 Include ...vhosts.conf）