phpEnv如何修改PHP doc_root phpEnv文档根目录

在IT行业这个发展更新速度很快的行业，只有不停止的学习，才不会被行业所淘汰。如果你是文章学习者，那么本文《phpEnv如何修改PHP doc_root phpEnv文档根目录》就很适合你！本篇内容主要包括##content_title##，希望对大家的知识积累有所帮助，助力实战开发！

应修改 Apache 的 DocumentRoot 和 Directory 路径而非 php.ini 中的 doc_root，因 phpEnv 使用模块或 FPM 模式使 doc_root 失效；需编辑 vhosts.conf 中 VirtualHost 段的两处路径并重启 Apache 验证。

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 和 共同决定文件能否被访问和执行
• 强行在 php.ini 里写 doc_root = /xxx 对模块模式无效，Apache 日志里可能报 PHP Warning: Directive 'doc_root' is deprecated

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

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

• 打开 phpEnv 安装目录 → Apache\conf\extra\vhosts.conf（Windows）或 etc/extra/vhosts.conf（macOS/Linux）
• 找到你要修改的站点段，例如：

  <VirtualHost *:80>
      ServerName www.tp.com
      DocumentRoot "C:/phpenv/www/www.tp.com"
      <Directory "C:/phpenv/www/www.tp.com">
          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，检查 块里的 Require all granted 是否漏写或拼错
• 如果返回 404，确认 Apache 是否真的加载了 vhosts.conf（看 phpEnv 日志里有没有 Include ...vhosts.conf）

真正容易被忽略的是：phpEnv 的「网站管理」界面里点「编辑」只能改域名和端口，改不了物理路径；路径必须手动编辑 vhosts.conf，且 DocumentRoot 和 两个地方必须完全一致，差一个字符都会导致 403 或 500。

本篇关于《phpEnv如何修改PHP doc_root phpEnv文档根目录》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！