
PHP 5.6 到 8.x 跨度很大,中间隔了 7.0、7.1、7.2、7.3、7.4 四个大版本。这一路上 PHP 把大量老写法直接删掉了,很多在 5.6 里跑得好好的代码,升上去就是白屏或者 500。这篇文章按"先查什么、改什么、怎么验证"的顺序,把常见的坑列出来,同时给一套能落地的迁移流程。
升级之前必须先做的事
第一步,全量备份。代码、数据库、配置文件,三样都要有,而且要有能快速回滚的路径。升级失败时,回滚速度决定了损失大小。
第二步,扫一遍报错。把程序跑一遍,把 error_reporting 开到最严,把 notice 和 warning 全都打出来,把日志存下来。这份日志就是后面要改的清单。很多项目在 5.6 下每天都有一堆 notice,从来没人管,升级到 8.x 之后这些 notice 会变成 fatal。
第三步,看扩展依赖。用 php -m 列出当前装的扩展,逐个确认新版有没有对应的包。有些老扩展在 8.x 里已经不维护了,要提前找替代方案。
坑一:mysql_ 系列函数全没了
这是最高频的一个。PHP 7.0 就把 mysql_connect、mysql_query、mysql_fetch_array 这一整套删掉了,8.x 更不可能有。
受影响的一般是老项目,或者从很老的教程抄来的代码。处理办法是换成 mysqli 或者 PDO。改的时候注意两点:一是参数顺序变了,mysql_ 的最后一个参数是连接标识,mysqli 是第一个;二是错误处理方式变了,mysql_ 靠返回值判断,mysqli 要走异常或者返回 false。
如果代码量很大,可以临时用一个兼容层顶一下,但兼容层只是过渡,长期还是要改干净。兼容层本身有性能损失,而且会掩盖问题。
坑二:ereg 系列正则没了
ereg、eregi、split、spliti 这几个函数在 7.0 被删了。对应的是 preg_match、preg_split。
换的时候不是改个函数名就行,因为正则语法本身不同。ereg 用的是 POSIX 语法,preg 用的是 PCRE,分隔符、转义规则、修饰符都不一样。直接替换大概率匹配不到东西。
正确的做法是逐个检查每一个正则,把 POSIX 语法翻译成 PCRE 语法,然后拿测试数据跑一遍确认。这一步不能偷懒,正则写错的后果是静默的:不报错,但功能不对。
坑三:构造函数老写法失效
PHP 4 时代有个写法:类名和函数名相同就是构造函数。PHP 7 之后这个写法被彻底废弃,只有 __construct 才算构造函数。
后果很隐蔽:老类里的同名方法不会自动执行了,对象初始化不了,后面的逻辑全错,但不报错。
检查办法是搜所有 class,看有没有和类名同名的方法,有就改成 __construct。这一步用脚本扫一遍很快,人工看容易漏。
坑四:动态属性和未定义变量的严格化
8.x 对未定义变量、未定义数组键、null 参与运算这些事变得严格很多。
典型表现:5.6 下 $arr['not_exist'] 返回 null 加一个 notice,8.x 下还是 notice,但如果开了严格模式或者用了某些函数,会直接抛错。还有字符串和数字的比较,5.6 下 'abc' == 0 是 true,8.x 下变成 false。这个改动影响巨大,很多老代码里的判断逻辑会集体失效。
处理办法是:所有数组取值前先判断键是否存在,所有变量使用前先初始化,所有比较尽量用全等。这些改动量大,但必须做。
坑五:参数顺序和默认值的那些函数
有些函数的参数顺序在版本之间调过,还有些函数的默认行为变了。比如某些字符串函数对 null 的处理、某些数组函数对键类型的要求。
这个没法靠记忆,只能靠实际测试。方法是在测试环境跑一遍完整业务流程,看哪里出问题。
建议准备一份"核心业务流程清单",把注册、登录、发布、支付、导出这些关键路径列出来,升级后逐条跑一遍。不要只测首页能不能开,首页能开不代表业务能跑。
坑六:扩展和第三方库
老项目通常依赖一堆第三方库,这些库自己也要适配新版 PHP。
检查方式:看 composer.json 里的依赖,逐个查它支持的最高 PHP 版本。不支持的要么升级库版本,要么找替代库。
这一步最容易卡住,因为有些库早就停止维护了,作者不更新,你只能自己改或者换。提前做这一步,能避免升到一半发现走不通。
坑七:编码和字符集
8.x 对字符集的处理更严格。老项目如果用的是 utf8 而不是 utf8mb4,遇到 emoji 或者四字节字符会出问题。
数据库连接时的字符集参数、表的字符集、字段的字符集,三处要一致。不一致会导致乱码或者截断,而且往往只在特定输入下才暴露。
检查办法是查一遍所有表的字符集,把 utf8 的改成 utf8mb4。改之前备份,改之后抽样验证中文和 emoji。
推荐的迁移流程
第一步,搭一个和线上尽量一致的测试环境,装目标版本的 PHP。
第二步,把代码拷过去,先跑一遍,把报错全部记下来。
第三步,按报错清单批量修改,改完再跑一遍,循环直到没有报错。
第四步,跑核心业务流程,逐条验证功能。
第五步,做压力测试,看性能有没有退化。有些代码在新版下会慢,因为内部实现变了。
第六步,灰度上线。先切一部分流量,观察错误日志和响应时间,稳定后再全量。
第七步,保留旧环境一到两周,随时能回滚。
性能上会有什么变化
整体上,7.x 和 8.x 比 5.6 快不少,官方给的数字是两倍左右。但实际项目里,提升幅度取决于代码质量。
如果代码里有大量字符串拼接、大量数组操作、大量数据库查询,新版会有明显提升。如果瓶颈在数据库或者网络,PHP 版本影响不大。
所以升级前先做一次性能基线,升级后再测一次。有对比才知道值不值。
最后几条实在建议
第一条,不要一次跨太多版本。5.6 升到 7.4,稳定一段时间,再升 8.x。分两步走,出问题好定位。
第二条,升级前先把 notice 全部清掉。notice 是未来的 fatal,这句话在 PHP 升级上特别成立。
第三条,不要相信"兼容模式"。有些工具号称能自动转换老代码,实际只能处理简单情况,复杂逻辑还是要人工改。
第四条,升级不是一次性任务。升完之后把项目的最低版本要求写进文档,以后新代码都按新标准写,别再往回兼容。
PHP 升级这事,麻烦但不难,难的是耐心。一步一步来,每步验证,基本都能升上去。
