直接 apt install php 不能实现多版本共存,因为它仅安装单个默认主版本(如 php8.1)并覆盖 /usr/bin/php 软链,无法并存;必须显式安装带版本号的包(如 php7.4、php8.1),并通过 update-alternatives 注册管理 CLI,默认 Nginx 也不会自动识别多版本,需在站点配置中手动指定 fastcgi_pass 到对应 php8.1-fpm socket 并重载服务。

为什么直接 apt install php 不能实现 PHP8.1 多版本共存
因为 apt install php 默认只装一个主版本(如 Ubuntu 22.04 装的是 php8.1),且会把 /usr/bin/php 软链指向它,覆盖原有版本。想共存,必须显式安装带版本号的包,例如 php7.4 和 php8.1,而不是笼统的 php。
常见错误现象:装完 php8.1 后 php -v 还是 7.4 —— 实际是系统没注册新版本到 update-alternatives;或者网站 502,其实是 Nginx 还在连旧版 php-fpm 的 socket。
- Ubuntu/Debian 必须先启用
ppa:ondrej/php源(sudo add-apt-repository ppa:ondrej/php && sudo apt update) - CentOS/RHEL 需启用 Remi 仓库并启用
php:remi-8.1模块(dnf module enable php:remi-8.1) - 装完后检查二进制是否存在:
ls /usr/bin/php*应看到php7.4、php8.1等独立命令
如何让 Nginx 按站点绑定 php8.1-fpm
Nginx 不会自动识别你装了几个 PHP 版本,必须在每个站点配置里手动指定 fastcgi_pass 到对应版本的 socket 或端口。
关键路径和验证点:
立即学习“PHP免费学习笔记(深入)”;
修复 Core bailout 状态损坏安全问题,以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误,改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- 确认
php8.1-fpm已启用并运行:systemctl is-active php8.1-fpm(应返回active) - 查 socket 路径:
grep '^listen =' /etc/php/8.1/fpm/pool.d/www.conf,典型值是unix:/run/php/php8.1-fpm.sock - Nginx 配置中必须写全路径:
fastcgi_pass unix:/run/php/php8.1-fpm.sock;,不能只写127.0.0.1:9000(除非你明确配了 TCP 监听) - 改完后务必执行:
sudo nginx -t && sudo systemctl reload nginx,否则配置不生效
怎么安全切换 CLI 默认 php 命令到 php8.1
直接 rm /usr/bin/php && ln -s /usr/bin/php8.1 /usr/bin/php 是高危操作——可能崩掉 apt、宝塔后台或系统脚本。正确做法是用 update-alternatives 注册多版本并交互选择。
实操步骤:
- 注册两个版本(假设已装
php7.4和php8.1):sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81 - 交互切换:
sudo update-alternatives --config php,输入对应编号 - 验证:
php -v和which php必须一致;php --ini显示的Loaded Configuration File路径应为/etc/php/8.1/cli/php.ini - Composer 必须显式调用:
php8.1 composer install,不能只写composer install
phpinfo() 显示版本没错但行为异常?重点查 OPcache 和扩展
切换 PHP-FPM 版本后,phpinfo() 显示 8.1,但页面逻辑还是老样子,甚至报错“undefined function”,大概率不是配置问题,而是缓存或扩展没对齐。
容易被忽略的三个点:
-
opcache.enable在/etc/php/8.1/fpm/php.ini里必须为On,且要手动清空:进宝塔「PHP管理」→ 找 8.1 →「设置」→「清除 OPcache 缓存」,或执行sudo systemctl restart php8.1-fpm - 扩展(如
redis.so、pdo_mysql.so)路径按 PHP 主版本隔离,/usr/lib/php/20210902/(7.4)和/usr/lib/php/20210902/(8.1)是不同目录,装错位置会静默失败 -
extension_dir必须匹配当前版本,查法:php8.1 -r "echo ini_get('extension_dir');",确保.so文件真放在这底下


















