phpEnv多站点配置易失败的根本原因是Apache的httpd-vhosts.conf路径、ServerName与hosts域名、httpd.conf中Include三者未对齐，导致403/404或跳默认页。
phpEnv 本身不提供图形化虚拟主机管理界面，也没有内置的站点启用/禁用命令。它本质是 Windows 下轻量级集成环境（含 Apache/Nginx/PHP/MySQL），靠手动改配置文件 + 重启服务实现多站点，和 XAMPP、WAMP 思路一致，但更简洁。
为什么 phpEnv 的多站点配置容易失败
常见报错是 403 Forbidden、404 Not Found 或直接跳转到默认首页，根本原因不是 phpEnv 本身有问题，而是三个地方没对齐：
- Apache 的
httpd-vhosts.conf里DocumentRoot路径写错（比如用了反斜杠\却没双写或没加引号） -
ServerName和本地hosts文件里的域名不完全一致（大小写、端口、www 前缀漏配） - 没在
httpd.conf中真正启用httpd-vhosts.conf—— 很多人只取消注释了Include行，却忘了确认该行是否被其他注释块包裹，或路径写成了相对路径
实际操作：三步配好一个新站点
假设你要加 blog.test，项目放在 D:\phpEnv\www\blog：
- 打开
D:\phpEnv\Apache\conf\extra\httpd-vhosts.conf，末尾追加：<VirtualHost *:80> ServerName blog.test DocumentRoot "D:/phpEnv/www/blog" <Directory "D:/phpEnv/www/blog"> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> ErrorLog "logs/blog-error.log" CustomLog "logs/blog-access.log" common </VirtualHost> - 编辑系统
hosts文件（C:\Windows\System32\drivers\etc\hosts），添加一行：127.0.0.1 blog.test - 确认
D:\phpEnv\Apache\conf\httpd.conf中这行已取消注释且路径正确：Include conf/extra/httpd-vhosts.conf（注意不是Include "conf/extra/httpd-vhosts.conf"带引号的写法，phpEnv 的 Apache 版本通常不认带引号的路径） - 重启 phpEnv 的 Apache 服务（点托盘图标 → Restart Apache）
多个站点共存时的关键细节
每新增一个站点，必须保证以下三点互斥且完整：
-
ServerName值全局唯一，不能重复；若要同时支持blog.test和www.blog.test，得加ServerAlias www.blog.test -
DocumentRoot必须是绝对路径，且目录真实存在、有读取权限（Windows 下建议右键文件夹 → 属性 → 安全 → 给Everyone或IIS_IUSRS读取权） - 日志路径如
logs/blog-error.log是相对于 Apache 的logs目录（即D:\phpEnv\Apache\logs\），不是相对于项目目录；如果写成"D:/phpEnv/www/blog/logs/error.log"，Apache 启动会失败且不报错，只会静默忽略该VirtualHost
phpEnv 下 PHP-FPM 不生效？这是正常现象
phpEnv 默认使用 mod_php（Apache 模块方式），不是 PHP-FPM。你不会在配置里看到 fastcgi_pass 或 php-fpm.sock —— 这不是 bug，是设计选择。想用 FPM，得手动切换 Web 服务器为 Nginx（phpEnv 支持双引擎），但那就脱离了“快速上手”初衷。多数本地开发场景下，mod_php 更稳定、调试更直接。
立即学习“PHP免费学习笔记（深入）”；
真正卡住人的，往往不是哪行配置写错了，而是改完没重启 Apache，或者改了httpd-vhosts.conf 却忘了检查 httpd.conf 里那行 Include 是否真生效——这种“改了等于没改”的状态，最容易让人反复怀疑人生。 
