phpenv不处理虚拟主机配置，仅管理php版本切换；虚拟主机失效必查web服务器配置、hosts映射及php-fpm/apache是否实际调用phpenv安装的php二进制。
phpenv 本身不处理虚拟主机配置
这是最常被误解的一点：phpenv 只负责管理 PHP 可执行文件的版本切换，它不触碰 Apache/Nginx 配置、不修改 hosts、不生成虚拟主机块。如果你发现“配置虚拟主机不生效”，问题一定出在 Web 服务器层，和 phpenv 无关。
常见错误现象包括：
- 浏览器访问
myproject.test显示 404 或默认首页 -
php -v显示的是你用phpenv local设定的版本，但phpinfo()输出的却是另一个版本 - 修改了
httpd-vhosts.conf却没效果，甚至重启 Apache 也无效
确认 PHP 实际运行版本是否匹配 phpenv 设置
Web 服务器（如 Apache + mod_php 或 Nginx + PHP-FPM）使用的 PHP 解释器，和你在终端里敲 php 调用的不是同一个东西。终端里的 php 是 phpenv 管理的 shim，而 Web 服务调用的是它自己配置的二进制路径（比如 /usr/bin/php 或 /opt/homebrew/bin/php）。
验证方法：
- 在项目中放一个
info.php，内容为<?php phpinfo(); ?>，用浏览器访问，看 “Loaded Configuration File” 和 “PHP Binary Path” - 对比终端执行
phpenv which php的输出 —— 如果两者路径不同，说明 Web 服务根本没用上phpenv安装的版本 - 若你用的是 PHP-FPM，检查
www.conf中的php_admin_value[extension_dir]或php-cgi路径是否指向phpenv安装目录（如~/.phpenv/versions/8.3.13/bin/php-cgi）
Apache/Nginx 虚拟主机配置失效的典型原因
即使 phpenv 搭建正确，虚拟主机仍可能不生效，核心是 Web 服务器未真正加载你的配置。
排查要点：
- Apache：确认
httpd.conf中Include conf/extra/httpd-vhosts.conf这行**没有被注释**，且httpd-vhosts.conf文件路径拼写准确（大小写、斜杠方向） - Nginx：检查
nginx.conf是否包含include sites-enabled/*.conf;，且你新建的站点配置已软链到该目录 - hosts 文件必须添加对应条目，例如
127.0.0.1 myproject.test；Windows 用户注意 hosts 在C:\Windows\System32\drivers\etc\hosts，需管理员权限保存 - 修改配置后必须重启服务：Apache 用
sudo apachectl restart，Nginx 用sudo nginx -s reload；单纯 reload 不一定重读所有 include - Windows 下如果用了
user.ini（常见于 ThinkPHP/Laravel 模板），它会干扰 PHP-FPM 行为，删掉并重启 Nginx
想让 phpenv 安装的 PHP 真正用于 Web 服务？得手动对接
phpenv 默认不集成 Web 服务器。要让它生效，你必须显式指定 Web 服务调用哪个 PHP 二进制。
具体做法取决于你的部署方式：
- Apache + mod_php：基本不可行 ——
phpenv编译的是 CLI 版本，不带 Apache 模块；改用 PHP-FPM 是更现实的选择 - Nginx + PHP-FPM：编辑 FPM pool 配置（如
www.conf），把php-fpm启动命令改为~/.phpenv/versions/8.3.13/bin/php-fpm，并确保listen.owner权限兼容 - 开发场景推荐使用
php -S内置服务器：在项目根目录运行php -S localhost:8000 -t public/，它会直接走phpenv当前版本，零配置虚拟主机 - 如果依赖 XAMPP/MAMP，它们自带 PHP，
phpenv对其完全无感 —— 此时应放弃phpenv，改用这些套件内置的多版本切换功能
真正容易被忽略的是：你花半小时配好 phpenv local 8.3.13，却忘了 Nginx 还在调用系统自带的 PHP 7.4。版本管理再优雅，Web 层不对接就是白忙。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
