PHP 8.0 命名参数顺序一调换就报 ArgumentCountError 怎么查

导出模块加了一个新参数,我把调用改成了命名参数,本地跑通就合了。上线十分钟,运营说导出按钮点了没反应。日志里一行 ArgumentCountError: Too few arguments to function App\Report\Export::run(), 1 passed and at least 2 expected。

函数签名是 run(array $rows, string $name, bool $zip = false, string $tpl = 'csv'),我调用写的是 run(data: $rows, tpl: 'xlsx'),只传了两个,看着没毛病。第一反应是不是参数名写错,对着源码一个字一个字核,data、tpl 都对。

后来在本地拿空数组试,报的也是同一个错。翻手册才确认命名参数的规则:只能跳过带默认值的参数,前面两个必填的 rows 和 name 必须先按位置传。我跳过了 name,PHP 在编译期就把位置参数算成一个,直接抛错。

试过把 tpl 挪到调用最前面,没用,位置参数必须是开头连续的那几个。试过补一个 name: '',能跑了,但导出文件名变成空串,下游的下载接口拒绝空文件名。

换的方案是给 name 加默认值,保留命名调用,同时在方法体里校验空值。这样调用方怎么写都不会在编译期炸。

// 必填参数不能用命名跳过
// 签名:run(array $rows, string $name = 'report',
//   bool $zip = false, string $tpl = 'csv')
$e->run(data: $rows, zip: true);   // 报错
$e->run($rows, 'orders', zip: true);
$r = new ReflectionMethod(Export::class, 'run');
foreach ($r->getParameters() as $p) {
    echo $p->getName(), PHP_EOL;
}

另一个坑比这次严重。命名参数绑的是形参名,不是位置,有人把 $data 改成 $rows 之后,所有写 data: 的调用方都会静默失效,直到运行时才炸。CI 里加了 PHPStan,命名参数和签名对不上直接红。

验证是把全项目的命名参数调用 grep 出来,一共 37 处,逐个对着签名核了一遍,有 4 处跳过了必填参数。修完重跑两条导出链路,文件都正常生成,文件名、行数、表头逐项比过。

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