PHP 8.0 升级后命名参数报 Unknown named parameter 怎么回退

升级到 PHP 8.0.30 后,退款接口报 Error: Unknown named parameter $order_id,栈顶停在 Call_user_func_array。这段代码三年没动过,7.4 上跑得好好的。

参数是表单里攒出来的关联数组,['order_id' => 88123, 'amount' => 990, 'reason' => '重复支付'],直接丢给 call_user_func_array。PHP 8 之前字符串键只是顺序无关的数组,内部按顺序取;8.0 起字符串键被解释成命名参数,函数形参叫 $id 不叫 $order_id,于是抛错。

同类问题还有一处:array_map 的回调里用 ...$args 展开关联数组,一样炸。全站 grep 到 41 处 call_user_func_array,其中 9 处传的是关联数组。

第一版在每个调用点前加 array_values,改到三十处手就麻了,新代码还会写错。后来收敛到公共的 Invoker::call,方法入口统一 array_values,业务侧只调这一个方法。

另一个坑是内部函数的参数名不算 API。htmlspecialchars($s, double_encode: false) 在 8.0 能跑,小版本之间参数名一动就断。项目里禁止对内部函数用命名参数,用 php-cs-fixer 的自定义规则拦下来。

确认修好的口径不是单测全绿,而是把那 9 处关联数组调用逐个用真实订单跑一遍。第一次跑还剩 2 处报错,都是把 ...$row 展开给构造函数,而构造函数形参和字段名不一致。

命名参数本身是好东西,只适合自己写的、签名稳定的方法。跨版本迁移的老代码,先把这一层剥干净再谈别的。

// PHP 8.0 起字符串键会被当成命名参数
call_user_func_array([$svc, 'refund'], $params);   // 报错
call_user_func_array([$svc, 'refund'], array_values($params));
$svc->refund(...array_values($params));

您可以还会对下面的文章感兴趣: