phpEnv 不直接管理多站点,需靠 Apache/Nginx 配置 + hosts 绑定实现;其“站点管理”仅自动生成目录、hosts 条目和虚拟主机配置,但必须手动检查 vhosts 文件、启用 Include、重启 Apache,并确保路径规范、权限正确及 Directory 指令完整。

phpEnv 本身不直接管理多站点,它只管 PHP 版本切换;多站点必须靠 Web 服务器(Apache/Nginx)配置 + hosts 绑定来实现。 否则你会看到“找不到站点”“404”或始终跳转到默认首页。
phpEnv 站点管理界面只是快捷入口,背后仍是 Apache/Nginx 配置
phpEnv 的“站点管理”功能(点击主页 → 网站 → 增加)本质是:
- 自动在
phpEnv\www下创建同名文件夹作为根目录 - 自动往系统
hosts文件写入127.0.0.1 www.yoursite.com - 自动生成对应虚拟主机配置(Apache 的
httpd-vhosts.conf或 Nginx 的sites-available文件) - 但这些配置默认只启用一个站点——新增站点后,必须手动确认配置是否生效、端口是否冲突
常见错误:点了“增加”就以为完事了,结果浏览器打不开。实际要检查:httpd-vhosts.conf 是否真追加了新 <VirtualHost> 块、httpd.conf 是否已开启 Include conf/extra/httpd-vhosts.conf、Apache 是否重启。
Apache 多站点必须改两个地方:vhosts 配置 + hosts 文件
phpEnv 默认用 Apache,所以重点在 Apache 配置。关键路径:
立即学习“PHP免费学习笔记(深入)”;
- 虚拟主机配置文件:
phpEnv\Apache\conf\extra\httpd-vhosts.conf - 系统 hosts 文件:
C:\Windows\System32\drivers\etc\hosts(需管理员权限保存)
每个站点至少加一段:
<VirtualHost *:80>
ServerName site-a.com
DocumentRoot "D:/phpEnv/www/site-a"
<Directory "D:/phpEnv/www/site-a">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
注意:
-
ServerName必须和hosts里写的完全一致(不区分大小写但建议全小写) -
DocumentRoot路径不能有中文、空格,且必须存在、有可读权限 - 如果多个站点都用
*:80,确保没其他程序(如 Skype、IIS)占着 80 端口 - 改完配置后,必须点 phpEnv 控制面板的“重启 Apache”,不是只“启动”
PHP 版本按站点隔离?phpEnv 不支持,得靠 .php-version 文件
phpEnv 的版本切换是全局或目录级的,不是按站点绑定的。想让 site-a.com 用 PHP 8.1、site-b.com 用 PHP 8.2,不能靠 phpEnv 界面设置,得这样:
- 在
D:/phpEnv/www/site-a/.php-version里写入8.1.10 - 在
D:/phpEnv/www/site-b/.php-version里写入8.2.8 - 确保 phpEnv 已启用自动检测:
eval "$(phpenv init -)"在 shell 配置中生效 - Apache 必须用 mod_php(而非 php-fpm)才能识别该文件;若用 php-fpm,则需为每个站点配独立 socket 和 pool,phpEnv 不提供图形化支持
也就是说:phpEnv 的“PHP 版本管理”和“多站点”是两条线,强行耦合容易出问题。生产环境建议用 Docker 或 Nginx + php-fpm 池隔离,本地开发则优先保证 PHP 版本统一,避免调试差异。
访问时 403 Forbidden?大概率是 Directory 权限或 DocumentRoot 路径错了
这是最常卡住人的一步。现象是:域名能解析、Apache 启动成功、但浏览器报 403 Forbidden。
- 先确认
DocumentRoot指向的目录下有index.php或index.html - 检查
<Directory>块里有没有漏掉Require all granted(Apache 2.4+ 必须) - 路径中的反斜杠
\在 Apache 配置里要写成正斜杠/,比如D:/phpEnv/www/site-a,不能写D:\phpEnv\www\site-a - 如果用了 ThinkPHP、Laravel 等框架,
DocumentRoot应指向public/子目录,不是项目根目录
别迷信 phpEnv 界面生成的配置——它有时会把路径写错,或漏掉关键指令。打开 httpd-vhosts.conf 手动核对,比反复点“重启”更省时间。



















