phpEnv切换PHP版本需先安装目标版本并配置PATH或socket路径，否则会报错；它仅管理CLI环境，Web服务需单独配置php-fpm，且Composer、定时任务等须各自对齐版本。
phpEnv 不是宝塔、不是 Homebrew、也不是 Docker，它本身不提供“一键切换”能力——所谓“一键”，其实是用户自己写的 shell 脚本或 alias，底层仍依赖系统已安装的多个 PHP 版本和手动配置的 PATH 或 php-fpm socket 路径。直接运行 phpEnv 切换却没提前装好 PHP 8.2，结果必然是 command not found 或 PHP version not found。
确认 phpEnv 是否真在用 PHP 8.2 而非假切换
很多用户执行了 phpenv local 8.2 或 phpenv global 8.2 后，php -v 依然显示 7.4，原因通常是：
- PHP 8.2 根本没通过 phpenv install 安装成功（常见于缺少
autoconf、openssl、zlib等编译依赖） - 执行完
phpenv rehash前就去验证版本，导致 bin 目录下的软链未更新 - 当前 shell 会话未重新加载环境变量，
source ~/.phpenv/versions/8.2.0/bin/php这种硬路径调用只是临时骗过自己，不是真实生效 - 项目根目录下有
.php-version文件，但内容写成了8.2.0（正确应为8.2），phpenv 无法匹配已安装版本
phpenv install 8.2 失败时最该查的三处日志
phpenv 编译失败不会自动抛出友好提示，得翻原始日志：
- 编译过程输出末尾的报错行，例如：
configure: error: Package requirements (sqlite3 >= 3.7.4) were not met→ 补brew install sqlite3（macOS）或apt install libsqlite3-dev（Ubuntu） -
~/.phpenv/cache/php-8.2.0.log里搜error:或fatal error，重点关注扩展启用失败，比如mcrypt已被移除，但你的 configure 参数里还带着--with-mcrypt - 若卡在
make阶段，看~/.phpenv/versions/8.2.0/build.log最后几行，常出现内存不足（virtual memory exhausted）或 GCC 版本太低（PHP 8.2 要求 GCC 8+）
切换后 Web 服务仍跑在 PHP 7.4 的根本原因
phpenv 只管 CLI 环境，完全不影响 Web 服务器（Nginx/Apache）背后的 php-fpm 进程。你 php -v 是 8.2，但网站打开还是 7.4，说明：
立即学习“PHP免费学习笔记（深入）”；
- Nginx 配置里
fastcgi_pass指向的是127.0.0.1:9000（默认 PHP 7.4 的 fpm 端口），而不是 PHP 8.2 的监听地址（如127.0.0.1:9002或unix:/tmp/php-cgi-82.sock） - PHP 8.2 的 fpm 服务根本没启：运行
~/.phpenv/versions/8.2.0/sbin/php-fpm -t测试配置，再用~/.phpenv/versions/8.2.0/sbin/php-fpm -D启动 - 你的 fpm 配置文件（如
~/.phpenv/versions/8.2.0/etc/php-fpm.d/www.conf）里listen和user/group权限与 Nginx worker 进程不一致，导致 socket 连接被拒绝
别忽略 .php-version 文件对 Composer 的隐性影响
Composer 默认用系统 php 执行，但如果你在项目目录下放了 .php-version，且用了 phpenv local 8.2，那么：
-
composer install会走 PHP 8.2 的 autoloader，但若composer.json里写了"platform": {"php": "7.4"}，它可能跳过某些 PHP 8.2-only 的依赖（如ext-gd新增函数） -
composer update生成的vendor/autoload.php可能包含 PHP 8.2 特有语法（如只读属性），在 PHP 7.4 环境下 require 就 fatal error - 更隐蔽的是：某些插件（如 Laravel Mix）内部调用
php执行脚本，若没显式指定#!/usr/bin/env php，它可能 fallback 到系统默认 PHP，而非 phpenv 当前版本
真正麻烦的从来不是“怎么切”，而是切完之后，CLI、fpm、Composer、定时任务、甚至 crontab 里的 php /path/to/script.php 全部要各自确认是否对齐——漏掉任意一个环节，都可能让线上行为和本地测试完全不一致。
