phpEnv虚拟主机配置入口在phpenv\apache\conf\vhost\目录，需新建.conf文件并重启Apache；必须用ProxyPass转发PHP请求至127.0.0.1:9000，DocumentRoot指向public目录，且需手动绑定hosts。
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 里是被忽略的。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 进
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> 不够，必须显式声明如何转发 PHP 请求。
常见错误现象：页面能打开，但 .php 文件直接下载或显示源码；或者返回 500 且 error_log 提示 proxy: fcgi://127.0.0.1:9000 connection refused。
正确写法示例（myapp.test.conf）：
<VirtualHost *:80>
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</VirtualHost>
注意点：
-
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
这个步骤复杂且易出错，多数小项目其实没必要拆；但如果某个项目老是 502 Bad Gateway 且日志显示 PHP-FPM 挂了，大概率就是多个项目争抢同一个进程池导致的崩溃。
最后强调一点：phpEnv 的 Apache 日志默认在 phpenv\apache\logs\，不是系统全局日志路径；出问题第一反应不是重装，而是看 error.log 里最末几行——90% 的配置失败原因，Apache 都已经写清楚了。
