确认PHP版本和环境类型后,按宝塔、LNMP.org或Ubuntu/Debian包管理选择对应升级方式,升级后须检查FPM状态、扩展加载及废弃函数兼容性,并严格执行数据库与网站备份。

确认当前PHP版本和环境类型
直接运行 php -v 和 which php,再看 ps aux | grep php-fpm,就能判断你用的是哪种LNMP:是宝塔面板、LNMP.org脚本,还是纯手动搭的Ubuntu/Debian包管理安装版。这三类升级路径完全不同——混用方法会导致PHP-FPM起不来、Nginx 502,甚至整个网站白屏。
- 宝塔用户:
/www/server/php/下有多个版本目录(如74、82),说明走的是面板多版本共存机制 - LNMP.org脚本用户:
/root/lnmp1.*/存在,且php -v输出里带“by LNMP”字样 - Ubuntu/Debian原生包安装:
dpkg -l | grep php能列出php8.1-fpm这类包名,且配置文件在/etc/php/8.1/
按环境选对升级命令,别硬编译
90% 的 PHP 版本过低问题,根本不需要下载源码、./configure、make——那是给定制模块或老旧系统兜底用的。现代LNMP环境都有更稳更快的方式:
- 宝塔面板:进「软件商店」→ 找到目标PHP(如
PHP-8.3)→ 点「安装」→ 安装完去「网站」→「设置」→「PHP版本」里切换。全程Web操作,不碰命令行 - LNMP.org脚本:SSH登录后
cd /root/lnmp1.*/ && ./upgrade.sh php→ 输入8.3.6→ 等自动完成。它会保留你的php.ini和扩展配置,但不会自动启用新扩展(比如swoole得手动装) - Ubuntu/Debian包管理:先加PPA源
sudo add-apt-repository ppa:ondrej/php && sudo apt update→ 再装新版sudo apt install php8.3 php8.3-fpm php8.3-mysql php8.3-opcache→ 修改Nginx配置里的fastcgi_pass unix:/var/run/php/php8.3-fpm.sock
升级后必查的三个断点
装完不是终点,很多故障发生在“以为升完了”的那一刻。重点盯住以下三项:
-
Nginx是否连上了新FPM:执行
sudo systemctl status php8.3-fpm看是否 active;再查tail -f /var/log/nginx/error.log,出现connect() to unix:/var/run/php/php8.3-fpm.sock failed就说明socket路径没对上 -
关键扩展是否加载成功:运行
php -m | grep -E 'redis|swoole|gd',如果空输出,得单独装,比如sudo apt install php8.3-redis或宝塔里进PHP设置页勾选启用 -
代码是否踩了废弃函数雷:PHP 8.0+ 移除了
mysql_connect、ereg等函数,WordPress插件或老CMS可能直接报Fatal error: Uncaught Error。临时解决可改php.ini中的error_reporting = E_ALL & ~E_DEPRECATED & ~E_NOTICE,但长期必须修代码
备份不是仪式,是止损底线
升级前只做两件事:用 mysqldump 备份数据库,用 tar -czf www-backup-$(date +%F).tar.gz /var/www 打包网站根目录。别信“小版本升级很安全”——PHP 8.2 到 8.3 就删了 create_function(),某段加密解密逻辑可能瞬间失效。更别提LNMP.org升级时若内存不足1GB,make 编译中途OOM,旧PHP二进制被覆盖又没备份,就只剩重装。
立即学习“PHP免费学习笔记(深入)”;











