PHP 7.4 升级到 8.x 的核心是保障老项目稳定运行，需重点把控 PHP 自身兼容性、小皮面板配置联动、扩展与环境适配三大环节。
小皮面板里把 PHP 7.4 升级到 8.x，核心不是“能不能装上”，而是老项目跑不跑得稳。直接换版本容易出 502、白屏、报错或功能异常，关键得盯住三块：PHP 自身兼容性、面板配置联动、扩展与环境适配。
一、先确认项目是否真能跨过去
别急着点安装按钮。PHP 8.0 起引入大量破坏性变更，很多 7.4 下正常运行的代码在 8.x 会直接报错或静默失败：
- 动态属性（如
$obj->xxx = 123）在 8.2 被标记为废弃，8.3 直接报致命错误；必须补声明或加#[AllowDynamicProperties] - 函数返回类型声明变严格，原来没写
: void或: array的方法，升级后可能因实际返回值不符而崩溃 - 构造函数属性提升（
public function __construct(public string $name) {}）是语法糖，但旧代码若用传统赋值方式混用，可能触发类型推断冲突 - 匹配表达式（
match）和 null 安全运算符（?->）虽是新特性，但若框架或 Composer 包未适配，反而引发解析失败
二、小皮面板内操作要分步，别“一键覆盖”
小皮支持多版本共存，这是优势，也是升级前提：
- 先在「软件管理 → PHP 版本」里安装目标版本（如 8.2.9），不要卸载 7.4 —— 留着做对照和回滚
- 进「网站」列表，逐个站点点击【管理】→【PHP 版本】，手动切换，切忌全局替换
- 切换后立刻访问前台和后台，重点测登录、表单提交、文件上传、数据库读写等主路径，别只看首页
- 留意错误日志：
/www/wwwlogs/你的域名.error.log，常见线索包括Deprecated、TypeError、ParseError
三、配套服务常被忽略，但最容易导致 502
PHP 版本变了，但 Nginx/OpenResty、PHP-FPM、SSL 配置未必自动跟上：
立即学习“PHP免费学习笔记（深入）”；
- 检查 PHP-FPM 是否启动：执行
ps aux | grep php-fpm，确认对应 8.x 的进程存在；若无，去「软件管理」里重启该 PHP 版本的服务 - 确认 socket 路径一致：站点配置中
fastcgi_pass指向的 socket 文件（如/tmp/php-cgi-82.sock）必须和 PHP-FPM 实际监听的一致 - SSL 证书路径可能失效：升级后小皮有时会重生成证书目录名（带哈希后缀），但 Nginx 配置仍引用旧路径，导致
SSL_CTX_use_certificate_chain_file failed - 扩展缺失：PHP 8.x 默认不带
mysql扩展（已彻底移除），必须改用mysqli或PDO_MySQL，并确认这些扩展已在面板中启用
四、升级后必须做的验证动作
装完不等于跑通，这几个动作建议写成 checklist：
- 用
php -v和php --ini登录服务器终端，确认 CLI 使用的是目标版本且配置加载正确 - 新建一个
info.php放到网站根目录，内容为<?php phpinfo(); ?>，浏览器访问，核对显示的版本、已加载扩展、Loaded Configuration File - 运行一次 Composer install/update（如有），避免包因平台配置不匹配而降级或跳过安装
- 若有单元测试，用新 PHP 版本重新跑一遍；没有的话，至少手工走查核心业务流程 3 轮
