在ThinkPHP8中需显式配置路由与方法签名以启用PHP8命名参数，控制器方法须标注类型与默认值，请求须用JSON数组传参；联合类型校验依赖PHP8原生机制，需禁用自动类型转换中间件并确保参数名大小写严格匹配。
在ThinkPHP8项目中正确使用命名参数调用控制器方法并让联合类型声明真正生效于运行时校验，避免因语法误用导致500错误或类型绕过。
控制器方法启用命名参数调用
ThinkPHP8默认不自动启用命名参数支持，必须显式配置路由或方法签名才能触发PHP8原生命名参数机制。
第一步：在控制器方法定义中明确标注参数类型与默认值，必需参数不能缺失，否则命名调用会直接报错。
第二步：确保该控制器方法被注册为可路由的public方法，且未被中间件拦截或反射解析跳过——ThinkPHP8的Route::get()默认不阻止命名参数，但自定义Router类若重写resolveMethodParams()则可能丢弃命名信息。
立即学习“PHP免费学习笔记（深入）”；
第三步：发起HTTP请求时，必须通过数组方式传参，不能依赖query string自动映射。例如使用curl发送POST请求时，body需为JSON：{"name":"张三","age":28,"status":"active"}，而非?name=张三&age=28——后者由框架解析为位置参数，命名参数失效。
这一步操作起来很简单，直接把JSON body发过去就行，但很多人卡在用GET传参以为能触发命名机制，结果根本没走PHP8的named parameter解析路径。
联合类型声明写法与运行时校验触发条件
ThinkPHP8本身不额外增强联合类型校验，完全依赖PHP8.0+原生引擎。只有当方法被实际调用且参数传入时，引擎才会执行联合类型检查。
方法一：在控制器方法签名中使用竖线（|）声明联合类型
【public function update(int | string $id, array | null $data): bool】
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
注意：返回类型也支持联合，但ThinkPHP8的Response自动转换逻辑可能覆盖原始返回，建议只对入参做联合声明。
方法二：搭配属性类型声明强化校验边界
在对应Model类中同步声明属性为联合类型，例如public int|string $user_id;，这样当模型赋值时（如$model->user_id = $request->input('id')），PHP会在赋值瞬间触发类型校验，比控制器层更早捕获错误。
方法三：禁用ThinkPHP的自动类型转换中间件
默认情况下，ThinkPHP8的app/middleware/Convert.php会把字符串数字强制转为int，这会绕过联合类型中的string分支校验。必须注释掉$this->convert($value, $type)这一行，否则int|string形同虚设——传入"123"会被悄悄转成123，永远进不了string分支。
命名参数调用时的顺序陷阱与修复
ThinkPHP8路由解析器会将请求参数按key匹配方法形参名，但若混用位置参数和命名参数，PHP引擎会在字节码编译阶段直接拒绝，抛出ParseError。
① 先写所有位置参数，再写命名参数——这是唯一合法混合方式。例如：update(123, data: ['name' => '李四'])合法；update(data: ['name' => '李四'], 123)非法，PHP根本不允许编译。
② 所有必需参数必须出现，哪怕用命名方式。跳过任何一个无默认值的参数，就会触发TypeError: Required parameter $xxx follows optional parameter。
③ 参数名严格区分大小写，Id和id是两个不同参数。ThinkPHP8的路由参数映射默认小写，若方法定义为public function edit(string $Id)，而URL里传id=123，则命名参数无法绑定，退化为位置传参，极易引发类型不匹配。
【务必检查控制器方法形参名与请求参数key完全一致（含大小写）】
