PHP 8.1 禁止可选参数前置，函数定义中带默认值的参数必须全部位于无默认值参数之后，否则运行时抛出 ArgumentCountError；命名参数无法绕过此限制，修复方式唯有调整参数顺序。
PHP 8.1 中 $container = "bowl" 放在 $flavour 前面直接报 ArgumentCountError
因为 PHP 8.1 彻底废除了“可选参数前置”的语法容忍。哪怕你用命名参数调用，只要函数定义里把带默认值的参数写在必选参数前面，PHP 就会在运行时把那个“可选”参数当作强制参数处理。
这和 PHP 8.0 的行为不同：8.0 只发 Deprecated 警告，还能跑通；8.1 直接拒绝执行，抛出 ArgumentCountError，错误信息明确指出：makeyogurt(): Argument #1 ($container) not passed —— 它已经不认 $container 是可选的了。
常见触发场景包括：
- 重构旧函数时没调整参数顺序，只加了默认值
- 从 PHP 7.x 升级到 8.1 后，原有函数定义未做兼容性检查
- 团队协作中有人误以为“命名参数能绕过顺序限制”，结果定义本身已违规
为什么命名参数也救不了这个定义
命名参数解决的是「调用时」的顺序问题，不是「定义时」的语义问题。PHP 解析函数签名阶段就完成了参数分类：一旦发现某个带默认值的参数后面跟着无默认值的参数，整个签名就被标记为“不合法”，后续所有调用（无论位置还是命名）都会被拦截。换句话说：function makeyogurt($container = "bowl", $flavour) 这个定义本身在 PHP 8.1 就是错的，不是调用方式的问题。
验证方法很简单：
- 删掉命名调用，改用全位置参数：
makeyogurt("cup", "mango")→ 同样报ArgumentCountError - 哪怕只声明不调用，
php -l不报错，但 runtime 一执行就崩
修复方案只有两个，没有中间路线
必须重排函数参数顺序，让所有必选参数在前、可选参数在后：✅ 正确写法：
立即学习“PHP免费学习笔记（深入）”；
function makeyogurt($flavour, $container = "bowl") {
return "Making a $container of $flavour yogurt.\n";
}
echo makeyogurt(flavour: "raspberry"); // OK
⚠️ 注意：
- 不能靠
null或类型声明“伪装”可选参数，比如string|null $container = null仍属于“可选参数前置”，照样报错 - 如果历史调用太多，建议先加一层兼容 wrapper，而不是硬扛错误
- IDE（如 PHPStorm）通常不会标红这个定义，得靠静态分析工具（如 PHPStan + level 6）或实际运行才能暴露
容易被忽略的边界情况
有些看似“安全”的写法其实一样危险：比如下面这些定义，在 PHP 8.1 下全部非法：
-
function sendMail($to, $subject = "", $body, $from = null)——$body必选却在$subject和$from中间 -
function connect($host, $port = 3306, $user, $pass)——$user和$pass都是必选，但被$port = 3306隔开 - 使用联合类型 + 默认值：
function log(?string $msg = null, int $level)——$msg有默认值，$level没有，依然触发规则
