PHP 8.1 强制位置参数前置、命名参数后置，函数定义中可选参数不得位于必需参数之前，反射调用不支持关联数组传参，否则均触发ArgumentCountError或语法错误。
命名参数必须在位置参数之后，否则直接报错
PHP 8.1 强制执行「位置参数前置、命名参数后置」的语法规则。一旦在命名参数后面再跟位置参数，比如 foo($a, name: 'x', $b)，会立即触发 Fatal error: Named parameter not followed by a comma is not allowed after a positional argument。这不是警告，是解析阶段就失败的语法错误。
常见于重构旧代码时：原先是 send($to, $subject, $body)，升级后想改成 send(to: $to, body: $body) 却漏掉 $subject，又在末尾补了个位置参数——这就会崩。
- 检查调用语句中所有参数是否严格满足「位置参数 → 命名参数」单向顺序
- 禁用混合写法：如果用了命名参数，就全部用命名参数，避免侥幸心理
- IDE（如 PHPStorm）通常会在编辑时标红提示，别忽略这类实时语法检查
方法定义里可选参数写在必需参数前面，PHP 8.1 直接当必需参数处理
这是 PHP 8.1 最隐蔽的坑：function makeYogurt($container = 'bowl', $flavour) 这种写法，在 PHP 8.0 只发 Deprecated，到 PHP 8.1 就变成运行时报 ArgumentCountError - makeYogurt(): Argument #1 ($container) not passed。哪怕你调用时用了命名参数 makeYogurt(flavour: 'raspberry')，$container 也会被强制要求传入。
根本原因：PHP 解析器现在把「定义时出现在必需参数前的可选参数」一律视为隐式必需参数，不区分调用方式。
立即学习“PHP免费学习笔记（深入）”；
- 立刻检查所有函数/方法定义，确保
required参数全部放在optional参数之前 - getter 类方法（如
getBalance($currency)）尤其高危——它本不该有参数，却因历史原因留着一个冗余形参，必须删掉 - 用
php -l扫描文件只能发现语法错误，这类定义问题需人工或静态分析工具（如 PHPStan）识别
反射调用类构造函数时传了关联数组，PHP 8.1 拒绝解析
PHPUnit 或自定义 DI 容器中常见：用 ReflectionClass::newInstanceArgs() 传入 ['User' => $mock] 这样的关联数组，PHP 8.1 会直接抛 ArgumentCountError。因为反射只认索引顺序，不支持键名映射——$user 是第一个参数，就必须是数组第一个元素，不能靠键匹配。
即使你写了 setConstructorArgs(['User' => $mock])，底层仍按 key 名去对参数名，而 PHP 8.1 的反射机制已移除这种宽松匹配。
- 修复方式唯一：调用前用
array_values()转成纯索引数组，例如$ref->newInstanceArgs(array_values($args)) - 不要依赖类内参数名自动绑定；构造函数参数顺序就是契约，测试代码必须严格对齐
- 若参数多且易变，建议改用工厂模式或配置对象（
new Example($config)），绕过反射传参
ArgumentCountError 不一定是参数少，也可能是签名被 PHP 8.1 重新解释了
看到 Too few arguments 别急着加参数。PHP 8.1 对参数规则的收紧，让很多原本能跑的代码突然失败。比如一个方法定义为 public function log($level = 'info', $message)，你以为 $level 是可选的，但 PHP 8.1 认定它是必需的——所以 $obj->log('error') 实际只传了一个值，却要填两个槽位，于是报错。
这类问题不会在开发环境立刻暴露，往往上线后才触发，因为本地可能还在用 PHP 8.0。
- 升级 PHP 版本前，务必用目标版本（如 8.1）跑一遍全量单元测试
- 重点关注含默认值参数的方法定义，逐个确认顺序是否合规
- CI 流水线里加一条
php -v && php -r "var_dump(function_exists('str_contains'));"类似的探针，避免环境混用
