“升级到 PHP 8.2 性能更好”,这句话只对了一半。老项目里一个不兼容的函数,就能让整站白屏。切换版本不是点一下按钮,而是一次小型迁移。

下面这套流程,是我们给客户做版本切换时固定用的,按顺序走,基本不会出大问题。
第一步:盘清依赖
先看三样东西:程序要求的 PHP 版本、用了哪些扩展、有没有加密或混淆代码。Discuz、WordPress、各类 CMS 的官方文档都会写兼容范围,别凭感觉。
扩展要逐个确认:mysqli、pdo_mysql、gd、curl、mbstring、fileinfo、opcache、redis。少一个就可能白屏或图片处理失败。加密代码通常绑定特定版本,升级前必须问开发商。
第二步:在测试环境切
不要直接在生产站点切。宝塔可以复制一份站点到测试目录,绑定临时域名,切版本后逐页点一遍:首页、列表、详情、后台登录、上传图片、提交表单、支付回调。
重点看三个地方:后台编辑器能否保存、图片能否上传、验证码能否显示。这三处最容易受扩展影响。
第三步:切换时的配置
宝塔里切换 PHP 版本后,要检查伪静态规则是否还在。不同版本的 Nginx 配置有时会被重写,伪静态丢了,内页全部 404。
还要检查上传限制、执行时间、内存限制。新版本默认值可能更严格,后台上传大图会失败。建议把 upload_max_filesize 设为 20M,post_max_size 设为 24M,max_execution_time 设为 120。
OPcache 要开,但改代码后记得清缓存,否则会看到旧页面。
第四步:灰度验证
生产切换后,先用自己的手机 4G 访问,避免浏览器缓存干扰。再看错误日志,PHP 的 warning 和 deprecated 都要处理,不要等到某个函数被移除才报错。
如果有多个站点共用同一个 PHP 版本,先切一个流量小的站,观察一天再切主力站。不要一次全切。
第五步:回滚预案
切换前记录当前版本、扩展列表、php.ini 关键项,并做一次数据库和站点文件备份。出问题时,宝塔里切回原版本通常只需几十秒,但如果新版本已经写入了不兼容的数据,回滚后也可能报错。
所以切换前要先停写,或者确认新版本没有改变数据格式。对内容站来说,文章数据一般没问题;对商城来说,订单和库存字段要特别小心。
扩展安装的坑
宝塔里切换版本后,扩展不会自动跟过去。mysqli、redis、imagick 这些要重新装,编译需要几分钟。装完后在 phpinfo 里确认,不要只看面板显示“已安装”。
有的扩展版本与 PHP 版本绑定,比如某些 redis 扩展只支持到 PHP 8.0。装不上时先看编译日志,通常是版本不匹配,换一个扩展版本即可。
切换后的性能调优
新版本默认的 opcache 配置偏保守,可以适当调大 memory_consumed 和 max_accelerated_files。PHP-FPM 的 pm.max_children 要按内存算,不要照抄网上的数字。
切换后观察一周的慢日志和错误日志,重点看 deprecated 提示。这些提示现在不影响运行,下一个大版本就可能变成致命错误。
如果站点同时开了 Redis 缓存,切换后先清一次缓存,避免旧序列化格式不兼容。
切换前把 php.ini 和站点配置各导出一份,回滚时能省很多时间。备份不是形式,是真出事时的退路。
相关阅读:伪静态规则配置。
常见问题
PHP 8 一定比 PHP 7 快吗?
大多数场景是的,但差距没有宣传的那么大。真正影响速度的是 opcache、数据库查询和缓存,不是版本号。
切换后后台白屏怎么办?
先看 PHP 错误日志,通常是扩展缺失或函数不兼容。临时切回原版本,再逐个排查。
能同时装多个 PHP 版本吗?
宝塔支持。不同站点可以绑定不同版本,这是过渡期最稳妥的做法,老站先留在旧版本,新站用新版本。
环境配置的完整清单可以对照环境配置清单,切换前逐项打勾。
