如何通过phpEnv升级PHP版本？

本文共计756个文字，预计阅读时间需要4分钟。

直接说结论：

phpenv install 装完新版本后 php -v 还是旧的？

这是最常见错觉——你以为装了就自动切了，其实没切。phpenv install 只是把新版本二进制丢进 ~/.phpenv/versions/8.3.13 目录，不会动当前激活状态。

• 必须显式执行切换命令，比如 phpenv global 8.3.13（全局）或 phpenv local 8.3.13（当前项目）
• 执行后立刻验证：php -v 和 which php ——后者必须指向 ~/.phpenv/shims/php，而不是 /usr/bin/php 或其他路径
• 如果 which php 没变，大概率是 shell 的 PATH 里有别的 PHP 路径排在 ~/.phpenv/shims 前面，检查 echo $PATH 输出顺序
• 偶尔 shim 缓存未更新，补一句 phpenv rehash 再试

切换后 Web 服务（Apache/Nginx）PHP 版本没变？

phpenv 管的是 CLI 环境，对 Web SAPI（如 mod_php、php-fpm）完全无感。Web 服务器用的 PHP 是独立进程，和 phpenv 无关。

• Apache 用户：确认是否启用了对应模块，例如 a2dismod php7.4 && a2enmod php8.3，再 systemctl restart apache2
• Nginx + PHP-FPM 用户：改 fastcgi_pass 指向新版本的 socket，比如 unix:/var/run/php/php8.3-fpm.sock，然后 systemctl restart php8.3-fpm
• 别指望 phpenv shell 8.3.13 能让网页跑出新版本——那是终端会话级变量，不影响守护进程

想批量升级多个项目的 PHP 版本，怎么避免一个个 cd 进去 phpenv local？

靠 .php-version 文件统一驱动，但得手动维护或脚本生成。

立即学习“PHP免费学习笔记（深入）”；

• 每个项目根目录放一个纯文本文件 .php-version，内容就一行，比如 8.3.13
• phpenv 会自动识别该文件并优先使用其中版本（比 global 更高优先级）
• 批量更新时，写个简单脚本遍历项目目录，echo "8.3.13" > .php-version 即可
• 注意：如果项目里已有 .php-version，且内容是 7.4.33，那 phpenv global 8.3.13 完全无效——本地文件永远赢

真正容易被忽略的是：phpenv 切换后，你 CLI 下的 Composer、phpunit、laravel-artisan 等工具链是否还正常？它们依赖的 php 命令路径变了，但某些全局 bin 脚本可能硬编码了旧解释器路径（比如开头是 #!/usr/bin/env php 的脚本），这种情况下得清掉 vendor/bin 重装依赖，或者确保系统 env 查找逻辑走的是 phpenv shim。