phpEnv如何配置虚拟主机 phpEnv安装使用指南-php教程-PHP中文网

phpEnv本身不提供图形化虚拟主机配置界面，需手动编辑Apache的httpd-vhosts.conf或Nginx的server配置文件，在其中添加VirtualHost或server块，并同步修改Windows hosts文件映射域名，最后重启服务并用httpd -t或nginx -t验证语法。

phpenv如何配置虚拟主机 phpenv安装使用指南

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 中未被注释。

在 httpd-vhosts.conf 里追加一个块，例如：

<virtualhost>
    ServerName myapp.test
    DocumentRoot "C:/phpenv/www/myapp/public"
    <directory>
        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），除非你在块里显式加 Require all granted 并确认路径拼写全对（Windows 路径反斜杠要转义或用正斜杠）
PHP 文件返回 404，大概率是 DocumentRoot 指向了项目根目录而非 public 或 web 子目录
返回 403 Forbidden，八成是块缺失或 Require all granted 没写，Apache 默认拒绝所有访问
域名解析没做：必须手动编辑 C:\Windows\System32\drivers\etc\hosts，加一行 127.0.0.1 myapp.test

phpEnv + Nginx 场景下怎么配

phpEnv 支持切换到 Nginx 模式，但它的 Nginx 配置文件位置不统一，常见路径有：

btpanel phpsite 宝塔面板PHP网站

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

下载

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 可能只显示“启动失败”，不报具体哪行错。