phpEnv环境下多项目虚拟主机配置指南-php教程-PHP中文网

phpenv虚拟主机配置入口在phpenv\apache\conf\vhost\目录，需新建.conf文件并重启apache；必须用proxypass转发php请求至127.0.0.1:9000，documentroot指向public目录，且需手动绑定hosts。

phpenv环境下多项目虚拟主机配置指南

phpEnv 是 Windows 下集成 Apache + PHP + MySQL 的一键环境包，它默认只开一个本地站点（如 http://localhost），想跑多个 PHP 项目并用不同域名访问（比如 project-a.test、project-b.test），必须手动配虚拟主机——但它的配置结构和标准 Apache 不完全一样，直接套用网上教程容易 403、500 或根本不生效。

确认 phpEnv 的 Apache 配置入口在哪

phpEnv 并不使用标准的 httpd.conf 主配置文件来管理虚拟主机，而是把每个站点的配置单独放在 phpenv\apache\conf\vhost\ 目录下，以 .conf 文件形式存在。启动时，phpEnv 会自动 Include 这个目录下的所有文件。

所以你不需要去改 httpd.conf，也不用碰 extra/httpd-vhosts.conf ——那个文件在 phpEnv 里是被忽略的。

实操建议：

进 phpenv\apache\conf\vhost\，新建一个文件，比如 myapp.test.conf
内容按 phpEnv 兼容格式写（见下一条）
保存后，在 phpEnv 控制面板点「重启 Apache」，不是「重载」

phpEnv 虚拟主机配置必须用 ProxyPass（不能只靠 DocumentRoot）

phpEnv 默认启用的是 Apache + PHP-FPM 模式（非 mod_php），这意味着 PHP 脚本不是由 Apache 内部模块解析，而是通过 FastCGI 转发给独立的 PHP-FPM 进程。所以光写 DocumentRoot 和 <directory></directory> 不够，必须显式声明如何转发 PHP 请求。

常见错误现象：页面能打开，但 .php 文件直接下载或显示源码；或者返回 500 且 error_log 提示 proxy: fcgi://127.0.0.1:9000 connection refused。

正确写法示例（myapp.test.conf）：

<virtualhost>
    ServerName myapp.test
    DocumentRoot "D:/projects/myapp/public"
<pre class="brush:php;toolbar:false;"><Directory "D:/projects/myapp/public">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

# 关键：必须加这一段，告诉 Apache 把 .php 请求交给本地 PHP-FPM
<FilesMatch \.php$>
    SetHandler "proxy:fcgi://127.0.0.1:9000"
</FilesMatch>

ErrorLog "logs/myapp.test-error.log"
CustomLog "logs/myapp.test-access.log" common

注意点：

btpanel phpsite 宝塔面板PHP网站

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

下载

9000 是 phpEnv 默认 PHP-FPM 端口，不要改成 9001 或其他——除非你改过 phpenv\php\php-fpm.conf
DocumentRoot 必须指向框架的 public 或 web 目录，不是项目根目录
路径中的反斜杠 \ 要换成正斜杠 /，Windows 下也必须这样写，否则 Apache 启动失败

本地 hosts 绑定和浏览器缓存最容易漏掉

phpEnv 不自带 DNS 服务，myapp.test 这种域名必须手动加到系统 hosts 文件，否则浏览器根本不会发请求到你的 Apache。

常见错误现象：“该网页无法访问”、“DNS_PROBE_FINISHED_NXDOMAIN”、“连接被拒绝”，但 localhost 能打开。

操作步骤：

用管理员权限打开记事本，打开 C:\Windows\System32\drivers\etc\hosts
在末尾新增一行：127.0.0.1 myapp.test（不要加 www. 前缀，除非你也在 ServerAlias 里写了）
保存后，在 CMD 执行 ipconfig /flushdns
浏览器访问前，清空 DNS 缓存（Chrome 地址栏输 chrome://net-internals/#dns → 点「Clear host cache」）

额外提醒：如果用了 Chrome 或 Edge，它们会缓存 HSTS 策略。若你之前用 HTTPS 访问过同名域名（哪怕只是试错），即使现在配的是 HTTP，也会强制跳转 HTTPS 并报错。此时要访问 chrome://net-internals/#hsts，删掉对应域名。

多项目共存时，PHP-FPM 进程池不能共用

phpEnv 默认只启一个 PHP-FPM 实例（端口 9000），所有虚拟主机都连它。这看似省事，但会导致问题：不同项目可能需要不同 PHP 版本、扩展或 ini 设置（比如一个要 opcache.enable=1，另一个要关）。

解决方法是为每个项目配独立的 PHP-FPM 进程池，但 phpEnv UI 不支持图形化添加。你得手动操作：

复制一份 phpenv\php\php-fpm.d\www.conf，改名为 myapp.conf
修改其中 listen = 127.0.0.1:9001（换新端口）、php_admin_value[error_log]、php_admin_value[doc_root] 等
在对应的 .conf 虚拟主机文件里，把 SetHandler 改成 proxy:fcgi://127.0.0.1:9001
重启 phpEnv，它会自动加载所有 php-fpm.d/*.conf