在 php 8.0 引入命名参数（named arguments）后，如果在一个函数或方法调用中混用了命名参数和位置参数，且将位置参数放在了命名参数之后，解释器会抛出 fatal error: cannot use positional argument after named argument。这是因为 php 的解析器无法确定后续未命名的参数应该对应哪个形参。
命名参数的解析规则
当你在调用函数时使用了 paramName: value 这种形式，PHP 会将该参数从参数列表中移除，并标记为已提供。随后的参数必须继续以命名方式提供，或者如果剩余的都是位置参数，它们必须按照函数定义的顺序依次匹配。一旦你开始使用命名参数，就不能再回头使用位置参数来填充前面的空缺，因为位置参数是按顺序匹配的，而命名参数已经打乱了这种顺序。
要避免这个错误，请确保所有位置参数都出现在任何命名参数之前。例如，如果函数定义为 function test($a, $b, $c)，你可以调用 test(1, b: 2, c: 3)，但不能调用 test(a: 1, 2, 3) 或 test(1, b: 2, 3)。后者中，b: 2 是命名参数，后面的 3 是位置参数，这会导致错误。
立即学习“PHP免费学习笔记（深入）”；
数组解包与命名参数的冲突
在实际开发中，经常遇到需要将数组中的元素作为参数传递给函数的情况，尤其是在使用 ... 运算符进行数组解包时。如果数组中包含键值对，且你试图将它们与位置参数混合使用，可能会触发上述错误。考虑以下场景：你有一个包含用户数据的数组，并希望将其传递给一个接受多个参数的构造函数或工厂方法。
<?php
// 定义一个示例类
class User {
public function __construct(
public string $name,
public int $age,
public string $email
) {}
}
// 准备数据数组
$data = [
'name' => 'Alice',
'age' => 30,
'email' => 'alice@example.com'
];
// 正确做法：全部使用命名参数或全部使用位置参数
// 方式一：全部使用命名参数（推荐，清晰）
$user1 = new User(
name: $data['name'],
age: $data['age'],
email: $data['email']
);
// 方式二：使用数组解包，但需确保顺序一致
// 注意：如果数组键名与参数名不一致，不能直接用命名参数解包
// 这里演示如果强行混合会发生什么
try {
// 错误示范：尝试在解包后添加位置参数，或反之
// $user2 = new User(...$data, extra: 'value'); // 如果函数有额外参数
// 更常见的错误是：
// $user3 = new User(name: $data['name'], $data['age']); // 错误！位置参数在命名参数后
} catch (Error $e) {
echo $e->getMessage();
}
// 正确解包方式：如果数组索引顺序与参数顺序完全一致
$values = ['Bob', 25, 'bob@example.com'];
$user2 = new User(...$values);
var_dump($user1);
var_dump($user2);
?>
在上述代码中，我们展示了两种正确的参数传递方式。第一种是使用命名参数，明确指定每个值的对应关系，这种方式可读性最强，尤其适用于参数较多的情况。第二种是使用数组解包 ...，但这要求数组元素的顺序必须与函数定义的参数顺序严格一致。如果你尝试在解包数组后添加额外的位置参数，或者在命名参数之后使用位置参数，就会触发 Cannot use positional argument after named argument 错误。因此，在使用数组解包时，务必确保数组的结构与函数签名完全匹配，或者将所有参数都转换为命名参数形式以避免歧义。
处理复杂参数组合的最佳实践
当面对具有大量可选参数的函数时，最佳实践是使用关联数组结合 extract() 或手动映射，或者使用配置对象模式。然而，对于现代 PHP 应用，推荐使用命名参数来提高代码的可读性和维护性。如果必须混合使用，请始终将位置参数放在前面，命名参数放在后面。此外，可以使用 func_get_args() 或反射机制来动态处理参数，但这通常用于框架底层实现，而非业务逻辑。对于大多数业务场景，保持参数传递的一致性是关键。
