symfony于2026年11月17日公布8.2控制器参数改进:联合与交集服务类型可用于控制器和可调用命令,查询参数、请求头可交由后续解析器构造对象,映射后的dto也可作为授权投票主体。8.2目前仍处测试阶段,这次是功能介绍,不是稳定版发布公告。
类型解析从服务注入扩展到请求输入
构造函数中已有的联合、交集类型自动装配规则,扩展到控制器动作和可调用命令。类型成员必须是同一服务的别名;混合联合与交集的DNF类型仍需用显式Autowire服务指定,不能把多个不相关服务随意放入一个联合类型就期待自动选择。

官方公告列出控制器与命令的服务类型支持规则。
MapQueryParameter和MapRequestHeader可把自己不能直接转换的值交给后续解析器,支持日期、Doctrine实体、ULID等对象。开发者可用新的SourceValueResolverInterface编写同类解析器,具体类型仍需要有对应解析逻辑。
映射对象授权保留前置检查
当IsGranted的subject读取映射参数时,Symfony先完成该参数映射与验证,再交给Voter。属性声明顺序仍有意义:不依赖该对象的前置身份检查可以先运行。旧Voter若曾把映射属性本身当作subject处理,需要调整为接收实际对象;无效输入也可能先返回校验错误。
实体列表与JSON输入补齐多个边界
MapEntity用于数组参数时改用findBy,查不到结果返回空数组,而不是404。需要排序和数量限制时仍使用expr;expr新增闭包形式,但属性中的闭包要求PHP 8.5。

官方示例按作者查询实体列表,数组返回语义与单个实体不同。
MapQueryString设置key后,可把单个查询参数中的JSON反序列化为DTO,畸形JSON返回400;未设置key时不会自动把每个看似JSON的字符串都解析成对象。MapRequestPayload还可在缺少专用解码器时,按媒体类型的+json或+xml后缀回退解码,已有专用编码器优先。
截至2026年11月18日,8.2最近的公开测试标签为8.2.0-BETA2,composer.json要求PHP至少8.4.1;8.2文档仍标为开发版。BETA标签属于测试版本,测试环境应核对各组件与依赖的实际版本。


















