PHP可空类型与函数默认参数的疑问及报错排查

一、sendMail方法添加默认数组参数后调用失败的可能原因 #

你给sendMail新增带默认空数组的$attachments参数后，依赖它的函数运行失败，常见原因有以下几种：

• 调用时传递了null给$attachments：你的参数类型声明是array $attachments = []，这要求该参数只能是数组类型，不能是null。如果遗留代码中存在调用sendMail时传递null作为第六个参数的情况（比如变量赋值错误、旧逻辑误传），会直接触发类型错误。此时要么排查所有调用点确保传递数组，要么将类型改为?array $attachments = []允许null传入。
• 遗留代码依赖参数数量判断：如果旧代码里有用func_get_args()、func_num_args()或反射获取sendMail参数数量并做逻辑处理的场景，新增参数后参数数量从5变为6，会导致这类判断逻辑失效。比如某段代码可能仅当func_num_args() === 5时执行特定逻辑，参数数量变化后逻辑不再成立。
• PHP版本兼容性问题：虽然mixed类型是PHP 8.0+引入的，但如果你的遗留应用运行在7.x及以下版本，mixed会被视为无效类型。不过你之前的代码已经使用mixed，这个可能性较低，但可以确认下运行环境的PHP版本。

二、可空类型与默认参数的关系解析 #

针对static public final function list(int $type = 0, bool $only_on_going = false, ?int $id_producer = null)这类函数，拆解设计逻辑如下：

1. 可空类型的核心作用 #

?int表示参数接受int类型值或者null，而int $type = 0只能接受int类型值，不允许传null。$id_producer设为可空，是因为业务上允许该参数处于“无指定值”的状态——既可以明确传null表示忽略生产者ID筛选，也可以传具体的int类型ID。

2. 可空参数加默认值null的意义 #

如果只写?int $id_producer不设默认值，调用函数时必须传递该参数（要么是int要么是null），不能省略。加上= null后，调用时拥有三种选择：

• 完全省略该参数，自动使用默认值null；
• 传递int类型的生产者ID；
• 传递null明确表示不指定生产者ID。

而$type和$only_on_going用非可空类型+默认值，是因为业务上这两个参数必须有明确的有效值（int或bool），不允许“无指定”状态，同时提供默认值方便调用时省略参数。

3. 为什么仅$id_producer设为可空？ #

这完全由业务需求决定：

• $type和$only_on_going有明确的默认业务逻辑（默认类型为0、默认显示进行中项目），且不允许传递null表示“无指定”，因此不需要设为可空；
• $id_producer存在“不需要筛选特定生产者”的场景，用null表示该状态，同时允许调用时省略参数，因此设计为?int $id_producer = null。

内容的提问来源于stack exchange，提问作者user21780455