PHP版本切换全攻略详解

PHP版本切换没有“一键通用”的解决方案，其方法完全取决于你的运行环境——命令行（CLI）需通过update-alternatives（Linux）或brew link（macOS）调整可执行文件路径；Web服务（Apache/Nginx）则必须单独配置模块加载或php-fpm连接路径；而phpenv、asdf等版本管理工具则提供项目级灵活切换；最关键的是，CLI与Web端的PHP版本互不影响，切换后务必分别验证php -v和网页phpinfo()输出，并重启对应php-fpm服务，否则极易陷入“以为切了却没生效”的常见陷阱。

PHP 版本切换取决于你的运行环境

没有统一的“修改 PHP 版本”命令，php -v 显示的版本由当前生效的 php 可执行文件路径决定。你得先确认自己用的是哪种环境：是系统自带的 CLI、通过包管理器（如 apt / brew）安装的多个版本、还是用 phpbrew / asdf 等版本管理工具，又或是 Web 服务器（Nginx/Apache）下的 CGI/FPM 模式。不同场景，改法完全不同。

Linux/macOS 命令行用 update-alternatives 或软链接切换

如果你用 apt（Ubuntu/Debian）装了多个 PHP 版本（比如 php8.1 和 php8.2），它们通常会自动注册到 update-alternatives：

• 查看已注册版本：sudo update-alternatives --list php
• 交互式切换：sudo update-alternatives --config php，然后选编号
• 若没注册，可手动添加：sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.2 82 --slave /usr/bin/php-config php-config /usr/bin/php8.2-config

macOS 上用 brew 安装的多个版本，更常用软链接方式：brew unlink php@8.1 && brew link php@8.2。注意 brew link 可能因冲突失败，此时加 --force 强制覆盖（但要清楚后果）。

Web 服务器里改 PHP 版本不是改 CLI

php -v 和网页里 phpinfo() 显示的版本可能不一致——因为 Apache/Nginx 调用的是 libphp.so 或独立的 php-fpm 进程。关键在配置文件：

• Apache：检查 LoadModule php_module 路径，或 SetHandler application/x-httpd-php 对应的模块版本
• Nginx + PHP-FPM：看 fastcgi_pass 指向哪个 socket 或端口，再查对应 php-fpm 配置里的 php_admin_value[extension_dir] 或直接运行 ps aux | grep fpm 找启动命令中的 php-fpm 路径
• 常见错误：改了 CLI 版本，但 php-fpm8.2 没启动，或 Nginx 还连着 127.0.0.1:9000（旧版 FPM）

用 phpenv 或 asdf 管理多版本最灵活

这类工具专为开发环境设计，能 per-project 切换版本，且不影响系统全局：

• phpenv install 8.2.12 → phpenv local 8.2.12（当前目录生效）
• asdf plugin-add php → asdf install php 8.2.12 → asdf local php 8.2.12
• 原理都是在 shell 启动时动态修改 $PATH，优先指向指定版本的 bin/ 目录
• 注意：这些只影响当前 shell 会话或子进程，不会改变 systemctl start php8.1-fpm 这类系统服务

真正容易被忽略的是：Web 服务和 CLI 是两套独立路径，改完记得分别验证 php -v 和 curl -s http://localhost/test.php | grep 'PHP Version'。FPM 进程还常驻内存，切完版本别忘了 sudo systemctl restart php8.2-fpm。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP版本切换全攻略详解》文章吧，也可关注golang学习网公众号了解相关技术文章。