PHP 8命名参数仅适用于带默认值的可选参数,调用时须将命名参数置于位置参数之后,不可重复指定同一参数,也不能绕过必填参数校验。
PHP 8 的命名参数到底怎么用
PHP 8 确实引入了命名参数(named arguments),但它和 Python 或 C# 的“关键字参数”不是一回事——它不改变函数定义,只影响调用方式。核心作用是跳过可选参数、提升可读性,不是为了重排序必填参数。
比如你调用 array_fill_keys($keys, $value),两个参数都必须传,不能写成 array_fill_keys(value: 'x', keys: ['a']),因为它们都不是可选参数。命名参数只对带默认值的形参生效。
- 必须配合函数签名中的默认值使用,否则会报
Uncaught Error: Named parameter $xxx does not exist - 位置参数仍可混用,但所有命名参数必须放在位置参数之后,例如:
foo('a', b: 2, c: 3)合法,foo(b: 2, 'a')直接报错 - 不能重复指定同一参数:既用位置又用命名(
foo('a', a: 'b'))会触发Cannot use positional and named argument at the same time
什么时候该用命名参数而不是传统调用
典型场景是函数参数多、默认值多、语义不直观。比如 DateTime::createFromFormat() 有 3 个参数,第 3 个 $timezone 是可选的,但省略时容易误判前两个参数顺序;又比如自定义的 http_request(string $url, array $options = [], ?string $method = 'GET'),当只想改 $method 却保留默认 $options,以前得写 http_request($url, [], 'POST'),现在可以写 http_request($url, method: 'POST')。
- 适合:参数 > 3 个、含多个可选参数、参数类型相同(如全是
int或全是string)易混淆 - 不适合:只有 1–2 个参数、所有参数都必填、参数名本身已非常清晰(如
strlen(string $string)) - 注意:扩展函数(如
curl_setopt())若未在 PHP 源码中声明参数名,则无法使用命名参数——PHP 8 只认 Reflection 中暴露的参数名
命名参数与参数解构、箭头函数的兼容性
命名参数本身不参与运行时解构,也不能直接用于箭头函数的参数列表(箭头函数只支持位置参数)。但它可以和 ...$args 配合:调用时用命名参数传入,函数内通过 func_get_args() 或 ReflectionFunction 拿到实际传入的键名,不过这属于高级用法,日常几乎不用。