OptionsResolver 的 setNormalizer() 可实现规范化，但 PHP 8.5.7 下闭包必须显式声明参数类型（如 Options $options, string|null $value），否则 resolve() 可能静默失败或抛 TypeError；规范化逻辑应统一放在 setNormalizer() 中，setDefault() 仅用于字面量或纯计算默认值；嵌套结构需逐层定义子 resolver 并单独设 normalizer；normalizer 在 resolve 最后执行，高风险操作须 try/catch。
直接用 OptionsResolver 的 setNormalizer() 就能做规范化，但必须注意 PHP 8.5.7 下闭包参数类型推导和严格模式的交互 —— 否则 resolve() 会静默失败或抛出 TypeError。
PHP 8.5.7 中 normalizer 闭包必须显式声明参数类型
PHP 8.5.7 默认启用严格类型检查，setNormalizer() 传入的闭包若未标注参数类型，OptionsResolver 内部调用时可能因类型不匹配而中断（尤其在嵌套解析中）。这不是 OptionsResolver 的 bug，而是 PHP 运行时行为变化。
-
Options参数必须写成Options $options，不能省略类型或用array - 第二个参数（原始值）建议显式标注，比如
string|null $value，避免str_replace()类函数收到null报错 - 不要依赖 PHP 8.5 的「宽松闭包类型推导」——它在 OptionsResolver 的反射调用链中不可靠
$resolver->setNormalizer('path', function (Options $options, string|null $value): string {
return rtrim((string) $value, '/').'/';
});
规范化 vs 默认值：别把逻辑塞进 setDefault()
setDefault() 是为提供 fallback 值，不是做数据清洗。如果在 setDefault() 里写 trim() 或 strtolower()，会导致两次解析时行为不一致：第一次用默认值触发 normalizer，第二次用户传值却绕过 normalizer（除非你也给该 key 单独设了 setNormalizer()）。
- 所有格式转换、空值处理、大小写归一化，统一走
setNormalizer() -
setDefault()只放字面量或纯计算（如sys_get_temp_dir()），不碰用户输入结构 - 若需“有值才规范化”，在 normalizer 里判断
$value !== null，而不是靠 default 回退
嵌套数组的规范化要逐层定义 resolver
PHP 8.5.7 对嵌套结构的类型推导更严格，setNormalizer() 无法自动递归处理子数组。你必须对每个嵌套层级单独创建 OptionsResolver 实例并调用 setNormalizer()。
立即学习“PHP免费学习笔记（深入）”；
- 用
setDefault('headers', function (OptionsResolver $resolver) { ... })定义子 resolver - 在子 resolver 中再调用
setNormalizer('user_agent', ...) - 父级的 normalizer 不会自动传播到子级；PHP 8.5.7 下试图在父级闭包里手动调用子级
resolve()会因类型不匹配报错
$resolver->setDefault('http', function (OptionsResolver $resolver) {
$resolver->setDefaults(['timeout' => 30, 'verify_ssl' => true]);
$resolver->setNormalizer('base_url', function (Options $options, ?string $value): string {
return rtrim($value ?? 'https://api.example.com', '/').'/';
});
});
容易被忽略的点：normalizer 执行时机与异常捕获
normalizer 在 resolve() 的最后阶段执行，此时所有默认值已合并、必需项已校验、类型检查已完成。这意味着：如果 normalizer 抛出异常（比如 json_decode() 失败），它不会被 InvalidOptionsException 包裹，而是原样抛出 —— PHP 8.5.7 的错误处理器会把它当作未捕获的 TypeError 或 RuntimeException。
- 在 normalizer 里做高风险操作（如解码 JSON、读文件路径）必须加
try/catch - 不要假设
$value一定是字符串或数组；OptionsResolver可能传入null或整型（取决于前面的验证规则） - 调试时可用
var_dump(gettype($value), $value)确认实际类型，PHP 8.5.7 的get_debug_type()在这里不如gettype()直观
