如何将VPS上的PHP版本从7.4升级到8.1

文章导读
处理VPS上的PHP版本升级,我倾向先把环境摸清楚,再动包。下面是我自己会走的流程,不一定适合所有发行版,但思路是通用的。
📋 目录
  1. 壹 先确认当前环境和代码兼容性
  2. 贰 选择软件源并安装新版本
  3. 叁 扩展与php.ini逐项核对
  4. 肆 运行配置和代码调整
  5. 伍 升级后的验证与回滚
A A

处理VPS上的PHP版本升级,我倾向先把环境摸清楚,再动包。下面是我自己会走的流程,不一定适合所有发行版,但思路是通用的。

先确认当前环境和代码兼容性

在动手之前,先确认当前PHP版本和已安装扩展。通过php -v和php -m可以快速列出版本和模块列表。重点查看是否使用到8.1中移除或变更的函数,比如each()、create_function()等。可以用PHPCompatibility的代码扫描工具对项目做一次静态检查,但不要只看报告,有些弃用提示在运行期才会暴露。

静态扫描一般用PHPCompatibility规则集搭配phpcs执行。如果没有现成测试环境,先备份一份代码,在本地跑一遍扫描。扫描报告只能作为参考,比如8.1里将隐式nullable参数标记为deprecated,这类问题在静态分析里不一定能全查出来,还是要结合运行日志看。

选择软件源并安装新版本

如果你使用Linux发行版的软件源,升级前需要先添加包含PHP 8.1的第三方源,例如Sury或Remi,然后执行apt或yum的update。安装完成后,将默认的PHP版本切换到8.1,并确认php-cli和php-fpm的版本一致。注意不要在未禁用旧版本时直接覆盖,否则可能造成依赖库冲突。

如何将VPS上的PHP版本从7.4升级到8.1

以Debian 11搭配Sury源为例,先安装必要的包,然后添加GPG密钥和源列表:

sudo apt install lsb-release apt-transport-https ca-certificates curl
curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
echo 'deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ bullseye main' | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

接着安装PHP 8.1和常用扩展。注意包名里的版本号,php8.1-curl和php-curl是两个包,后者可能仍指向7.4。

sudo apt install php8.1 php8.1-fpm php8.1-cli php8.1-mysql php8.1-curl php8.1-mbstring

安装完成后,用update-alternatives把默认php命令切到8.1,然后重启php8.1-fpm。之前7.4的fpm服务如果没有必要就停掉,免得端口冲突。

sudo update-alternatives --set php /usr/bin/php8.1
sudo systemctl restart php8.1-fpm

扩展与php.ini逐项核对

升级后最容易出问题的不是语言本身,而是扩展。诸如php-json在8.0起已成为核心,无需单独安装;而php-mysqlnd的包名可能变化。务必使用php -m对照之前的模块列表逐一核对。如果缺少扩展,用包管理器安装对应版本,例如php8.1-curl。同时检查php.ini中的extension_dir路径,确保没有把7.4的.so路径写死。

如何将VPS上的PHP版本从7.4升级到8.1

我习惯把升级前的php -m输出存到文件,升级后diff一下。有些扩展不一定有现成的包,比如某些商业扩展只支持到7.4,这时候只能考虑升级前替换掉方案。另外,php.ini里的extension_dir要指向php8.1对应的目录,例如/usr/lib/php/20210902这类带PHP API版本的路径。如果直接复制旧配置,很容易把路径残留成7.4的。

运行配置和代码调整

PHP 8.1对错误报告更敏感,默认会把一些历史代码的Deprecated警告暴露出来。我通常会设置error_reporting = E_ALL,display_errors = Off,log_errors = On,并指定错误日志文件。这样前端不显示警告,但后端能看到具体问题。

error_reporting = E_ALL
display_errors = Off
log_errors = On
error_log = /var/log/php-error.log

对于使用opcache的项目,升级后需要清一次缓存,因为opcache的序列化格式在新版本里可能不兼容。8.1默认开启了opcache.jit,如果某些老扩展在JIT下表现异常,可以先关闭jit观察。代码里如果用了create_function这类被移除的函数,需要改写为匿名函数;隐式nullable参数要显式加上?号。

如何将VPS上的PHP版本从7.4升级到8.1

升级后的验证与回滚

升级后先运行项目自带的测试集,如果没有测试,至少跑一遍核心业务流程。在这里特别留意登录、表单提交、文件上传这些环节,因为session处理和文件上传相关的扩展改动比较多。

在生产环境,建议保留旧版PHP的安装包和配置文件的备份。如果出现严重兼容问题,可通过update-alternatives或手动修改Nginx/Apache的PHP-FPM配置快速切回PHP 7.4。注意回滚后要重启php-fpm并清理session或缓存目录,避免残留数据导致key不匹配。

回滚命令和升级类似,把8.1换成7.4,然后重启fpm。但更稳妥的是提前把php7.4-fpm也装好,并且保持它的配置文件不被破坏。这样切换时只需要改一遍php-fpm的监听地址。