Linux下PHP版本切换方法详解

在Linux系统中，PHP版本混乱的根源在于CLI命令行、Web服务器（如Apache或Nginx+PHP-FPM）各自独立使用不同的二进制文件、配置路径和扩展机制，导致`php -v`与`phpinfo()`显示版本不一致、配置修改无效、扩展缺失报错等常见问题；本文直击痛点，系统讲解如何精准定位CLI和Web环境各自的`php.ini`加载路径、通过`update-alternatives`安全切换默认CLI版本、借助多实例PHP-FPM实现站点级版本隔离，以及升级后快速启用对应版本的扩展模块，帮你彻底理清三套环境（CLI/FPM/Apache）的依赖关系，告别“改了没生效”的调试迷局。

php -v 显示的版本和 web 里不一致？查 php.ini 加载路径才是关键

Linux 下 PHP 版本混乱，根本原因不是没装对，而是 CLI 和 Web（如 Apache/FPM）用了两套配置、甚至两个二进制。运行 php -v 看到的是命令行版本，而浏览器访问显示的是 Web 服务器加载的 PHP 模块版本。

必须先确认实际生效的配置位置：
php --ini —— 查 CLI 的配置路径
phpinfo()（写个临时 PHP 文件用浏览器打开）—— 查 Web 环境的 Loaded Configuration File

• 两个环境的 php.ini 可能完全不同，改错地方等于白改
• Web 环境下，Apache 用 libphp 模块，Nginx + PHP-FPM 则由 php-fpm 进程控制，改完要重启对应服务（systemctl restart apache2 或 systemctl restart php8.1-fpm）
• FPM 配置文件通常在 /etc/php/8.1/fpm/php.ini，别只改 /etc/php/8.1/cli/php.ini

用 apt 安装多个 PHP 版本后，怎么切系统默认的 php 命令？

Ubuntu/Debian 默认只允许一个 php 命令指向一个版本，靠 update-alternatives 管理，不是简单 ln -sf。

操作前先确认已安装的版本： ls /usr/bin/php* —— 看有没有 php8.1、php8.2 这类带版本号的二进制

• 如果还没注册进 alternatives，先执行：
  sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81
sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.2 82
• 切换时用：
  sudo update-alternatives --config php —— 交互式选择
• 注意：这个只影响 CLI 的 php 命令，不影响 Web 环境，也不影响 Composer（它会读 PHP_BINARY 或自己找）

PHP-FPM 多版本共存：一个站点用 8.1，另一个用 8.2，怎么配？

Nginx 不直接调用 PHP 二进制，而是把请求转发给 PHP-FPM 的 socket 或端口。所以“多版本”本质是跑多个 php-fpm 实例，每个监听不同 socket，再在 server 块里指定 fastcgi_pass。

例如让某个站点走 8.2：
fastcgi_pass unix:/run/php/php8.2-fpm.sock;

• 确保对应版本的 FPM 已启用并运行：
  sudo systemctl enable php8.2-fpm
sudo systemctl start php8.2-fpm
• 检查 socket 文件是否存在：
  ls /run/php/php8.2-fpm.sock —— 如果没有，可能是 FPM 启动失败，看日志：
  sudo journalctl -u php8.2-fpm -n 20
• 每个 FPM 实例有独立的 www.conf（如 /etc/php/8.2/fpm/pool.d/www.conf），里面 listen = 必须唯一，不能多个版本监听同一个 socket

升级 PHP 后网站报 Class not found 或 undefined function？优先查扩展是否启用

PHP 主版本升级（如 7.4 → 8.1）后，很多扩展默认不自动启用，尤其是非核心扩展（如 gd、mbstring、curl）。错误不是代码问题，而是扩展没加载。

查当前启用的扩展：
php -m | grep -E 'gd|mbstring|curl'（CLI）
phpinfo() 页面里搜索 “Loaded Extensions”（Web）

• Debian/Ubuntu 下，扩展包名带版本号，比如 php8.1-gd，升级 PHP 后旧扩展包不会自动迁移，得手动装：
  sudo apt install php8.2-gd php8.2-mbstring php8.2-curl
• 扩展配置文件在 /etc/php/8.2/mods-available/，启用需软链到 /etc/php/8.2/fpm/conf.d/ 和 /etc/php/8.2/cli/conf.d/，或用：
  sudo phpenmod -v 8.2 gd mbstring curl
• 有些扩展（如 apcu）在新版 PHP 中行为变更，即使启用了也可能抛异常，得看具体报错堆栈再判断是不是兼容性问题

版本切换最麻烦的从来不是装几个包，而是搞清 CLI、FPM、Apache 模块三者各自加载哪份配置、哪个二进制、哪个扩展目录。漏掉任意一环，就会出现“明明改了却没生效”的情况。

今天关于《Linux下PHP版本切换方法详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！