phpEnv本身不提供虚拟主机功能，它仅管理PHP版本；虚拟主机配置依赖Apache或Nginx（如XAMPP、phpStudy内置服务），需修改httpd-vhosts.conf、hosts文件并重启Apache，且路径不能含中文或空格，hosts须管理员权限编辑并刷新DNS缓存。
phpEnv 本身不直接提供虚拟主机配置功能，它只是一个 PHP 版本管理工具（类似 pyenv 或 rbenv），**不内置 Web 服务器**。你看到的“phpEnv 配置虚拟主机”，实际是搭配了 Apache 或 Nginx（比如 XAMPP、WampServer、phpStudy 内置的 Apache/Nginx）在 Windows 上运行，phpEnv 只负责切换 PHP 解析器版本。
所以真正要配虚拟主机，关键不是 phpEnv，而是它背后那个 Web 服务——绝大多数用户用的是 phpStudy 或 XAMPP 自带的 Apache。下面分三块说清楚怎么做、为什么、容易卡在哪。
Apache 的 httpd-vhosts.conf 怎么改才生效
很多用户改完 httpd-vhosts.conf 刷新页面还是 404，第一反应是“phpEnv 没配好”，其实根本没轮到它。
- 确认
httpd.conf中这行没被注释：Include conf/extra/httpd-vhosts.conf -
VirtualHost块里DocumentRoot必须指向真实存在的目录，且路径中不能有中文或空格（比如E:/my project就会失败，改成E:/my_project） -
ServerName值必须和你在hosts文件里写的完全一致（大小写不敏感，但点号、连字符不能错） - Windows 下改完
httpd-vhosts.conf后，一定要重启 Apache 服务（不是只刷新浏览器）
hosts 文件怎么写才不被系统拦截
Win10/Win11 默认禁止普通用户修改 C:\Windows\System32\drivers\etc\hosts，直接右键记事本打开保存会失败，提示“权限不足”。
- 必须以管理员身份运行记事本：开始菜单搜“记事本” → 右键 → “以管理员身份运行” → 文件 → 打开 → 浏览到
etc目录 → 显示所有文件 → 选中hosts - 添加格式严格为：
127.0.0.1 myapp.test（前后不能有空格，不能写http://，不能多写#注释在行首以外的位置） - 加完保存后，命令行执行
ipconfig /flushdns清 DNS 缓存，否则可能仍解析不到
phpEnv 切换 PHP 版本后，虚拟主机还生效吗
会生效，但有个隐藏前提：你用的 Apache 必须是通过 mod_php 方式加载 PHP，而不是 PHP-FPM。而 phpStudy 和 XAMPP 默认都是 mod_php，所以只要 phpEnv 切换后，Apache 重启时能加载对应版本的 phpX.dll，虚拟主机就照常工作。
- 检查 Apache 是否加载了正确 PHP：访问
http://localhost/phpinfo.php，看Loaded Configuration File路径是否指向你当前phpEnv激活的版本（如C:\Users\XXX\.phpenv\versions\8.2.12\lib\php.ini） - 如果显示的是旧版本路径，说明 Apache 还在用原来编译进模块的 PHP，这时候需要手动修改
httpd.conf里的LoadModule php_module和PHPIniDir指向新路径（phpEnv不自动改这个） -
phpEnv的phpenv global 8.2.12只影响 CLI，不影响 Web 环境 —— Web 环境的 PHP 版本由 Apache 配置决定
VirtualHost，而是改了三处配置（vhosts、hosts、php.ini），却只重启了其中一处服务，或者 hosts 写错了一个点，然后花两小时查 phpEnv 文档。Web 服务链路是「浏览器 → hosts → Apache → VirtualHost → PHP 模块」，断在哪，就得去哪查。 
