宝塔面板PHP升级实为多版本共存下的安装新版本+切换+卸载旧版；需检查程序兼容性、扩展配置继承、.user.ini锁定、PHP-FPM状态及日志错误，卸载前确认无残留依赖。
宝塔面板里 PHP 版本太低，不能直接“升级”，得换版本
宝塔面板不支持在原有 PHP 安装基础上“原地升级”（比如从 7.2 升到 8.1），它用的是多版本共存机制。所谓“升级 PHP”，实际是安装新版本 + 切换网站使用的 PHP 版本 + 卸载旧版本。强行改配置或覆盖安装极易导致站点 500、PHP-FPM 启动失败、甚至面板后台报错。
- 面板后台「软件商店」→「PHP」列表里，绿色「安装」按钮对应的是尚未安装的版本
- 已安装的版本右侧有「设置」「删除」「设为默认」等操作，但没有「升级」选项
- 切换前务必确认新版本与你的程序兼容（例如 Laravel 10 需 PHP ≥8.1，Typecho 1.2 最高只支持到 PHP 8.2）
安装新 PHP 版本时注意扩展和配置继承问题
新装的 PHP 版本默认使用独立的 php.ini 和扩展集，不会自动继承旧版本的修改。常见踩坑点：装完 8.2 发现 Redis 扩展没开、upload_max_filesize 还是 2M、或者 opcache 没启用。
- 安装时勾选常用扩展（如
redis、memcached、fileinfo、exif），但ionCube和ZendGuard需单独在对应 PHP 版本的「设置」→「安装扩展」里加载 - 新版
php.ini路径为/www/server/php/82/etc/php.ini（以 8.2 为例），修改后必须重启对应 PHP-FPM：执行service php-fpm-82 restart或在面板「PHP 管理」里点「重载配置」 - 某些程序依赖
mysql扩展（已废弃），新版 PHP 默认只提供mysqli和pdo_mysql，需检查代码中是否硬写了mysql_connect()类函数
网站切换 PHP 版本后 502 或空白页？优先查这三项
切换后页面打不开，大概率不是版本本身问题，而是环境链路断了。别急着重装，先快速验证三个关键节点。
- 确认网站根目录下
.user.ini文件没锁定旧 PHP 版本（如含open_basedir或php_version=72字样，删掉或改成匹配当前版本） - 进「网站」→「设置」→「PHP 版本」，确认下拉菜单里选中的是你刚安装并启动成功的版本（例如
PHP-82），且状态显示「运行中」 - 看错误日志：
/www/wwwlogs/你的域名.error.log，高频错误如Primary script unknown（伪静态没配对）、Connection refused（PHP-FPM 没起来）、Class not found（扩展缺失）
卸载旧 PHP 前必须确认无残留依赖
面板「PHP」列表里点「删除」看似简单，但若还有网站、计划任务、或其它软件（如 phpMyAdmin、OneAuth）绑定着旧版本，删完会导致功能异常。尤其 phpMyAdmin 默认跟随主 PHP 版本，删掉 7.4 后如果面板还用它，可能进不去数据库管理页。
立即学习“PHP免费学习笔记（深入）”；
- 执行
grep -r "php-version.*74" /www/server/panel/vhost/查所有网站配置是否还引用php-version=74 - 检查「计划任务」里是否有用
/usr/bin/php或具体路径调用脚本，那些脚本可能依赖旧版语法或扩展 - 卸载后建议保留旧版本的
php.ini备份（如/www/server/php/74/etc/php.ini.bak），以防回滚需要
最麻烦的不是装新版本，而是旧程序没做兼容性测试就切过去。上线前务必用测试站跑一遍核心流程：登录、上传、支付回调、定时任务——别只看首页能打开。
