phpEnv本身不提供图形化虚拟主机配置界面，需手动编辑Apache的httpd-vhosts.conf或Nginx的server配置文件，在其中添加VirtualHost或server块，并同步修改Windows hosts文件映射域名，最后重启服务并用httpd -t或nginx -t验证语法。
phpEnv 本身不直接提供图形化虚拟主机配置界面，它只是一个本地 PHP 环境管理工具（类似 pyenv 或 nvm），负责切换 PHP 版本、启用扩展、启动内置服务器等。你要配虚拟主机，实际是在它底层调用的 Apache 或 Nginx 上操作 —— phpEnv 只是帮你启停服务、选版本，不替你写 vhost.conf 或 nginx.conf。
phpEnv 启动的 Apache 怎么加虚拟主机
phpEnv 默认使用 Apache（部分版本也支持 Nginx），其配置文件路径取决于安装方式，但通常位于：
C:\phpenv\apache\conf\extra\httpd-vhosts.conf
你需要确保主配置已加载该文件：Include conf/extra/httpd-vhosts.conf 在 httpd.conf 中未被注释。
立即学习“PHP免费学习笔记（深入）”；
在 httpd-vhosts.conf 里追加一个 <virtualhost></virtualhost> 块，例如：
<VirtualHost *:80>
ServerName myapp.test
DocumentRoot "C:/phpenv/www/myapp/public"
<Directory "C:/phpenv/www/myapp/public">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
关键点：
-
ServerName必须和你本地hosts文件中映射一致，否则浏览器打不开 -
DocumentRoot要指向项目真实入口（如 Laravel 的public目录，不是根目录） -
AllowOverride All才能让.htaccess生效，否则路由重写（如 Laravel 的index.php隐藏）会失败 - 改完后必须重启 Apache：在 phpEnv GUI 点击「Restart Apache」或命令行执行
phpenv apache restart
为什么改了 vhosts.conf 还是 403 或 404
常见错误不是配置写错，而是权限或路径没对齐：
- Apache 默认不允许访问
C:盘以外的路径（比如D:\myproject），除非你在<directory></directory>块里显式加Require all granted并确认路径拼写全对（Windows 路径反斜杠要转义或用正斜杠） - PHP 文件返回 404，大概率是
DocumentRoot指向了项目根目录而非public或web子目录 - 返回 403 Forbidden，八成是
<directory></directory>块缺失或Require all granted没写，Apache 默认拒绝所有访问 - 域名解析没做：必须手动编辑
C:\Windows\System32\drivers\etc\hosts，加一行127.0.0.1 myapp.test
phpEnv + Nginx 场景下怎么配
phpEnv 支持切换到 Nginx 模式，但它的 Nginx 配置文件位置不统一，常见路径有：
C:\phpenv\nginx\conf\vhost\myapp.conf 或 C:\phpenv\nginx\conf\servers\myapp.conf
内容结构类似：
server {
listen 80;
server_name myapp.test;
root "C:/phpenv/www/myapp/public";
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
注意：
- Nginx 不读
.htaccess，重写规则全靠location块写死 -
fastcgi_pass必须和 php-fpm 监听地址一致；phpEnv 默认用127.0.0.1:9000，别写成unix:/tmp/php-fpm.sock - 改完 Nginx 配置后，不能只 reload，得先 stop 再 start：phpEnv GUI 点「Stop Nginx」→「Start Nginx」
真正容易被忽略的是：phpEnv 的 Apache/Nginx 都是 Windows 服务封装，它不会自动帮你校验配置语法。每次改完 vhosts.conf 或 nginx.conf，务必先用命令验证：
Apache：httpd -t（路径在 C:\phpenv\apache\bin）
Nginx：nginx -t（路径在 C:\phpenv\nginx）
语法错一条，整个服务就起不来，但 phpEnv GUI 可能只显示“启动失败”，不报具体哪行错。
