PHP升级后出错多因语言行为变更,需按版本差异排查:重点检查count(null)、foreach遍历非数组、mb_*编码参数、__toString()返回值、短箭头函数作用域五类高频问题,并用php -l和error_reporting提前暴露Deprecated/Warning/Fatal error。

PHP 升级后出错,不是代码写错了,大概率是语言层行为变了——得按版本差异点去查,而不是盲目改逻辑。
看错误信息里有没有 Deprecated、Warning 或 Fatal error 关键字
这些提示直接指向兼容性断点:
-
Deprecated:旧写法还能跑,但下个大版本会删(比如mysql_connect()在 PHP 7.0+ 已移除) -
Warning:可能不影响执行,但行为已变(比如array_key_exists(null, $arr)在 PHP 8.0+ 报 Warning) -
Fatal error:直接中断(比如 PHP 8.0+ 严格类型下,json_decode('')返回null,若没判空就调用方法会报Call to a member function ... on null)
重点检查这五个高频崩点位置
升级后最常出问题的不是业务逻辑,而是底层调用和类型假设:
-
count(null):PHP 7.x 返回1,PHP 8.0+ 报Warning并返回0;别再默认count($var) > 0判数组非空,先用is_array($var)或is_countable($var) -
foreach遍历非数组/Traversable:PHP 7.x 静默跳过,PHP 8.0+ 直接Fatal error;加is_array($data) || $data instanceof Traversable再遍历 -
mb_*函数默认编码变化:PHP 7.4 默认UTF-8,PHP 8.0+ 强制要求显式传$encoding参数,否则可能乱码或警告;统一补上mb_internal_encoding('UTF-8')或每个调用加'UTF-8' -
__toString()方法返回非字符串:PHP 7.x 容忍隐式转换,PHP 8.0+ 要求必须返回string,否则Fatal error - 短箭头函数
fn()作用域限制:不能访问$this或use动态变量,误用会报Parse error;老代码里混用function() use ($x)和fn()时尤其注意
用 php -l + error_reporting 快速定位
别等上线才暴露问题,本地就能筛出大部分隐患:
- 批量扫描文件:
find ./app -name "*.php" -exec php -l {} \; 2>&1 | grep -E "(Deprecated|Warning|Fatal)" - 临时提高报告等级,在入口文件开头加:
error_reporting(E_ALL | E_STRICT); ini_set('display_errors', '1');(注意别在生产环境开display_errors) - PHP 8.0+ 新增
zend.assertions = 1+assert.exception = 1,可把老式assert()调用转为异常,方便捕获
不要只测“能跑”,要测“边界输入”
很多兼容问题只在特定数据下触发,比如:
- 传
null给原本只收string的函数(trim(null)在 PHP 8.1+ 报TypeError) - 数据库字段为空时,
mysqli_fetch_assoc()返回false,但有人直接foreach(false as ...) -
json_encode()遇到资源句柄(如fopen()返回值)在 PHP 8.0+ 默认返回false,老代码可能没做判断就继续序列化
升级后最容易被忽略的,是那些“一直没出事”的边缘 case —— 它们往往藏在日志里不报错,但结果已错。建议对所有外部输入($_GET、DB 查询结果、API 返回)加一层 var_dump(gettype($x), $x) 快速确认实际类型。











