phpenv不支持升级已安装php版本，仅支持安装新版本并切换；每次install均独立编译安装至全新路径，旧版本保留不变，需手动rehash、重装扩展、配置web服务器及php-fpm。
直接说结论：phpenv 本身不提供“升级”某个已安装 PHP 版本的功能，它只支持「安装新版本 + 切换」。所谓“平滑升级”，实际是安装目标版本后，通过 phpenv global 或 phpenv local 切换生效，旧版本保留不动——不是覆盖，而是替换运行时指向。
phpenv install 装的是全新独立版本，不是 patch 升级
很多人误以为 phpenv install 8.2.10 会把已装的 8.2.9 “升级”成 8.2.10，其实不是：phpenv install 每次都从源码完整编译、安装到独立路径（如 ~/.phpenv/versions/8.2.10），和之前版本完全隔离。你装了 8.2.9 和 8.2.10，它们共存，互不影响。
- 不会修改任何已有版本的二进制或配置文件
- 不自动迁移扩展、自定义
php.ini或pecl包——这些都得手动处理 - 如果你依赖某个 PECL 扩展（比如
redis或igbinary），必须在新版本里重新pecl install
切换前必须 rehash，否则 which php 还指向旧版本
装完新版本后，php -v 可能仍显示老版本，常见原因是没执行 phpenv rehash。这个命令会扫描 ~/.phpenv/versions/ 下所有 bin 目录，重建 shims（即 ~/.phpenv/shims/php 等软链接）。
- 每次
phpenv install后都要手动运行phpenv rehash - 如果
which php返回的是/usr/bin/php或其他系统路径，说明~/.phpenv/shims没被优先加载——检查$PATH是否把~/.phpenv/shims放在最前面 - 验证是否生效：运行
phpenv version（显示当前激活版本）和phpenv versions（带 * 标记当前）
项目级切换要注意 .php-version 文件权限和 Git 忽略
用 phpenv local 8.3.13 会在当前目录生成 .php-version 文件。这个文件内容就是纯文本 8.3.13，但有几个实操细节容易踩坑：
- 文件权限要是普通可读（644），别设成 755，否则某些 CI 环境可能报权限错误
- 团队协作时，建议把它加入
.gitignore——因为不同开发者本地环境版本未必一致；改用phpenv global+ 文档约定，或靠 CI 脚本用PHPENV_VERSION=8.3.13 phpenv shell控制 - 如果项目根目录下有
.php-version，又在子目录执行phpenv local 7.4.33，那子目录会覆盖父目录设置——层级关系是“最近的 .php-version 优先”
Web 服务（Apache/Nginx）不感知 phpenv，需额外配置
phpenv 只管 CLI 环境下的 php 命令，对 Web 服务器完全透明。也就是说，即使你用 phpenv global 8.3.13，Apache 还是跑着系统自带的 libphp.so，Nginx 还连着旧的 php-fpm socket。
- 要让 Web 请求走新版本，必须单独配置：Apache 用户需
a2dismod php7.4 && a2enmod php8.3；Nginx 用户要改fastcgi_pass指向新版本的php-fpmsocket（比如unix:/home/youruser/.phpenv/versions/8.3.13/var/run/php-fpm.sock） - phpenv 安装的 PHP 默认不启动
php-fpm服务——需要手动运行~/.phpenv/versions/8.3.13/sbin/php-fpm，或写 systemd unit（很多用户卡在这一步，以为“切换完了”，结果网页 502） - CLI 和 Web 使用的
php.ini是两个文件：php --ini显示 CLI 路径，phpinfo()显示 Web 路径，别混淆
最常被忽略的一点：phpenv 切换的是 shell 当前会话的 php 命令，但它不改变系统级服务（如 php-fpm）、不重载 Web 服务器、也不帮你迁移扩展。真正的“平滑”，靠的是你提前验证新版本的 php-fpm 能否启动、扩展是否装全、php.ini 配置是否兼容——而不是指望工具自动做完所有事。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
