phpenv仅管理PHP版本，不管理站点；执行phpenv local只生成.php-version文件以指定当前目录的PHP命令版本，不影响Web服务器（如Nginx/Apache）或PHP-FPM对站点的实际处理。
phpenv 本身不管理站点，它只管理 PHP 版本；所谓“phpenv 管理多个站点”是常见误解，混淆了版本管理与 Web 服务配置两个层级。
为什么 phpenv local 不等于“切换站点”
执行 phpenv local 7.4.33 只会在当前目录生成一个 .php-version 文件，告诉 phpenv：这个路径下运行 php 命令时，应调用 7.4.33 版本的二进制文件。它不会：
- 自动启动 Apache/Nginx
- 绑定域名或设置 DocumentRoot
- 加载对应站点的配置、环境变量或数据库连接
- 影响其他进程（如 PHP-FPM 池、Web 服务器子进程）
换句话说：phpenv 控制的是「你手动敲 php script.php 时用哪个 PHP」，不是「浏览器访问 site-a.com 时用哪个 PHP」。
真正决定站点行为的是 Web 服务器 + PHP-FPM 配置
当你在浏览器中打开 http://site-a.com，请求由 Nginx/Apache 接收，再转发给 PHP-FPM 处理。此时起作用的是：
立即学习“PHP免费学习笔记（深入）”；
- Nginx 的
server_name site-a.com和root /var/www/site-a - PHP-FPM 池配置中的
php_admin_value[extension]或php_flag[display_errors] - FPM 池使用的 PHP 版本（通过
listen = /run/php/php7.4-fpm.sock这类路径硬编码指定） - Web 服务器是否将
SITE_ENV=site_a注入到 CGI 环境中（供 PHP 读取$_SERVER['SITE_ENV']）
如果你希望不同站点用不同 PHP 版本，必须为每个站点配独立的 FPM 池，并指向对应版本的 sock 文件（如 php8.2-fpm.sock），phpenv 对此完全无感知。
如何让 phpenv 和多站点协同工作
虽然 phpenv 不直接管站点，但它能提升本地开发流的可靠性：
- 在
/var/www/site-a目录下执行phpenv local 7.4.33，确保你本地运行php -l app.php或phpunit时用对版本 - CI 脚本中用
phpenv global 8.3.13统一测试环境，避免因系统默认 PHP 版本漂移导致 CI 失败 - 配合 Composer：不同站点的
composer.json可能要求不同 PHP 版本约束（如"php": "^7.4"），phpenv local能提前暴露兼容性问题 - 避免全局
php被误升级：用phpenv global system临时切回系统 PHP，验证是否是 phpenv 引起的问题
注意：phpenv rehash 必须在每次安装新 PHP 后运行，否则 php 命令仍可能指向旧版本 shim —— 这是本地命令行和 CI 中最常踩的坑。
容易被忽略的关键点
很多人以为只要 php -v 显示正确版本，站点就一定跑在该版本上。但实际中：
-
which php显示的是 phpenv shim 路径（如~/.phpenv/shims/php），而 Web 服务器调用的是fastcgi_pass指定的 FPM socket，二者完全独立 - 修改
.php-version不会触发 FPM 重启，也不会改变phpinfo()输出的版本号 - 若用
php -S启动内置服务器做快速调试，phpenv local才真正生效；但生产环境几乎不用它
归根结底：站点是 Web 服务器的概念，PHP 版本是解释器的概念，phpenv 只负责后者。把它们串起来，靠的是你对 Nginx/Apache/FPM 三者协作关系的理解，而不是某个 magic 命令。
