phpenv是windows下轻量级php集成环境,需手动配置apache虚拟主机并修改hosts文件实现多域名绑定,不支持gui一键添加域名。

phpEnv 是 Windows 下轻量级 PHP 集成环境(类似 XAMPP、WAMP),默认基于 Apache,但不自带图形化虚拟主机管理界面。它本身不提供“一键添加域名”的 GUI 功能,所有多域名绑定必须手动修改 Apache 配置并配合系统 hosts 文件完成。
phpEnv 的 httpd-vhosts.conf 必须显式启用
phpEnv 安装后,httpd-vhosts.conf 通常位于 phpEnvApacheconfextra 目录下,但默认是**未被主配置加载**的。你不能只往里面加 <virtualhost></virtualhost> 就生效。
- 打开
phpEnvApacheconfhttpd.conf - 搜索
Include conf/extra/httpd-vhosts.conf,确认该行**前面没有#注释符**;如果没有,就取消注释 - 同时确保
mod_rewrite和mod_vhost_alias已启用(搜索LoadModule rewrite_module和LoadModule vhost_alias_module,确保它们未被注释) - 改完必须重启 phpEnv 的 Apache 服务(通过托盘图标或命令行)
每个域名必须独立 <virtualhost></virtualhost> 块
不能把多个 ServerName 堆在同一个 <virtualhost></virtualhost> 里试图共享配置——那样只会让第一个匹配的生效,其余域名可能 fallback 到默认站点或 404。
- 在
httpd-vhosts.conf中为每个域名写一个完整块,例如:
<virtualhost>
ServerName site1.test
DocumentRoot "D:/www/site1"
<directory>
AllowOverride All
Require all granted
</directory></virtualhost><virtualhost>
ServerName site2.test
DocumentRoot "D:/www/site2"
<directory>
AllowOverride All
Require all granted
</directory></virtualhost>
-
DocumentRoot路径必须用正斜杠/或双反斜杠\,单反斜杠会报错 -
ServerName后不要加http://或端口;如需 www 版本,用ServerAlias www.site1.test - 目录权限段
<directory></directory>不可省略,否则 403 Forbidden
本地测试必须改 C:WindowsSystem32driversetchosts
phpEnv 没有 DNS 解析能力,所有自定义域名都依赖本地 hosts 文件映射到 127.0.0.1。
- 用管理员权限打开记事本,拖入
hosts文件编辑 - 追加两行(每行一个域名):
127.0.0.1 site1.test 127.0.0.1 site2.test
- 保存后无需重启系统,但浏览器缓存可能干扰,建议用无痕窗口测试
- 如果访问时跳转到 phpEnv 默认首页(如
index.php?m=home),说明请求没命中任何VirtualHost,大概率是hosts拼错、ServerName大小写不一致,或 Apache 没重载配置
PHP-FPM 不参与 phpEnv 的默认 Apache 模式
phpEnv 默认使用 Apache 的 mod_php(即 PHP 作为模块运行),不是 PHP-FPM。所以你**不需要也不应该**配置 fastcgi_pass、php-fpm.sock 这类 Nginx / FPM 专用参数。
- 如果你看到网上教程提到
fastcgi_pass或php8.1-fpm.sock,那适用于 Nginx + PHP-FPM 组合,和 phpEnv 原生模式无关 - 想用 PHP-FPM,得手动切换 phpEnv 的运行模式(极不推荐:phpEnv 并未为此优化,容易出路径、权限、进程管理问题)
- 确认是否走 mod_php:访问
http://127.0.0.1/phpinfo.php,看Server API显示的是Apache 2.0 Handler而非FPM/FastCGI
真正容易被忽略的是:phpEnv 的 Apache 配置文件路径分散且无统一入口,改错文件(比如只改了 httpd.conf 却漏掉 extrahttpd-vhosts.conf 的 Include)、或改了配置但没点托盘图标里的「Restart Apache」,都会让所有操作白费。每次修改后,务必检查 Apache 错误日志(phpEnvApachelogserror.log)里有没有 syntax error 提示。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











