必须升级php至8.1/8.2并手动配置扩展、路径与日志，否则laravel 11和wordpress 6.7+无法运行；宝塔面板升级本身不解决兼容性问题，关键在分层验证与灰度切换。

直接升级宝塔面板本身不能让旧环境支持 Laravel 11 或 WordPress 6.7+——真正卡住的是 PHP 版本、扩展、路径引用和配置细节。平滑的关键不是“一键升级”，而是分层验证与灰度切换。

确认当前 PHP 是否已实质过期

宝塔显示“PHP已过期”不是提示语，是明确告警：PHP 7.4 已 EOL（2022年11月终止支持），PHP 8.0 的安全支持也将在 2026年11月结束。截至 2026年4月，PHP 8.1 和 8.2 才是 CMS 与框架实际兼容的稳定主力版本。

• 进宝塔 → 软件商店 → 找到已安装的 PHP 版本，点“设置”看右上角是否标有 EOL 或 Security Only
• 打开终端执行 php -v，比对输出版本与 PHP 官方支持周期表，别信面板文字描述
• 若当前是 PHP 7.4 或 8.0，必须装 8.1/8.2 并切换网站绑定，否则 Laravel 11 的 #[\Override] 语法、WordPress 6.7 的 JSON 模式校验会直接报错退出

装新 PHP 后必须手动完成的三件事

很多人装完 PHP 8.2 就刷新网站，结果还是 500 或白屏——因为宝塔不会自动帮你配齐运行环境。

• 进网站 → 设置 → PHP版本，下拉菜单里选中刚装的 PHP-82（不是默认的“跟随系统”或旧版本）
• 进 PHP-82 管理页 → 安装扩展，勾上 mbstring、curl、pdo_mysql、openssl、json、xml；缺任意一个，Composer install 或 WP 插件激活就失败
• 点“重载配置”（不是“重启PHP服务”）——Nginx/Apache 必须重新读取 fastcgi_pass 参数，否则请求仍发给旧 PHP 进程

检查所有外部调用路径是否还指向旧 PHP

升级后最隐蔽的故障源：计划任务、Shell 脚本、自定义监控、甚至 crontab 里硬编码的 /usr/bin/php，在新版宝塔中全部失效。

• 进面板 → 计划任务，逐条检查 Shell 类任务，把 /usr/bin/php 替换为 /www/server/php/82/bin/php（版本号按你实际安装的改）
• 检查网站根目录下的定时脚本（如 backup.sh）、Logrotate 配置、或自写健康检查脚本，它们很可能还在调用系统默认 php
• 宝塔旧插件（如“一键部署”）可能残留 php-cgi 调用，进软件商店点“修复”或卸载重装

上线前必须验证的兼容性断点

PHP 8.0+ 移除了 mysql_* 函数、禁用动态属性、json_decode() 默认返回 array 而非 stdClass，这些不会立刻报错，但会在特定分支逻辑里崩掉。

• 进 PHP-82 设置 → 配置修改，把 error_reporting 改成 E_ALL，log_errors 设为 On，错误日志路径保持默认（/www/wwwlogs/php_errors.log）
• 访问网站关键路径（如 WP 后台、Laravel /horizon、支付回调接口），再查日志是否有 Deprecated、Warning 或 Notice
• 若只看到警告没中断，可临时加 error_reporting = E_ALL & ~E_DEPRECATED & ~E_NOTICE 过渡，但上线前必须清掉——这些不是噪音，是未来 PHP 9.0 的致命错误前兆

最容易被忽略的，是 DNS 切换前没验证新服务器的 SSL 强制跳转是否生效，或 /www/wwwroot/ 目录权限错配成 root:root 导致 php-fpm 无法读取文件——这些和 PHP 版本无关，却让整个“平滑升级”变成线上事故。