symfony分组校验支持按场景激活不同验证规则：注册时要求邮箱唯一、密码≥8，修改资料时昵称必填而邮箱可不变；通过groups选项定义约束分组，控制器中传入分组数组触发验证，表单中配置validation_groups联动，嵌套对象用@assert\valid指定分组传播。
Symfony 分组校验用于在不同场景下对同一对象应用不同的验证规则。比如注册时要求邮箱唯一、密码长度≥8；而修改资料时邮箱可不变、但昵称不能为空——这时不能靠一套约束解决，得用验证分组（Validation Groups）来按需激活规则。
定义分组约束
在实体类中，给每个约束指定 groups 选项，值为字符串或字符串数组：
- 使用注解方式（最常见）：
// src/Entity/User.php
use Symfony\Component\Validator\Constraints as Assert;
class User {
/**
* @Assert\NotBlank(groups={"registration"})
* @Assert\Length(min=2, groups={"registration", "profile"})
* @Assert\Email(groups={"registration"})
*/
public $name;
/**
* @Assert\NotBlank(groups={"registration"})
* @Assert\Length(min=8, groups={"registration"})
* @Assert\Length(min=6, max=20, groups={"profile"})
*/
public $password;
}
在控制器中触发指定分组验证
调用 Validator 服务时传入分组名数组，只检查属于该组的约束：
- 获取 validator 服务（自动注入推荐）：
public function register(Request $request, ValidatorInterface $validator)
{
$user = new User();
// ... 绑定表单数据
$errors = $validator->validate($user, null, ['registration']);
if (count($errors) > 0) {
// 处理错误
}
}
注意：第二个参数为 null 表示不指定约束映射类（即全部默认约束），第三个参数才是分组数组。
与表单组件联动（Form + Groups）
当使用 Symfony Form 时，在构建表单类型时直接配置验证分组：
- 在 FormType 类中设置：
public function configureOptions(OptionsResolver $resolver)
{
$resolver->setDefaults([
'data_class' => User::class,
'validation_groups' => ['registration'], // 或回调函数
]);
}
- 动态分组可用回调，例如根据请求方法或用户状态切换：
'validation_groups' => function (FormInterface $form) {
return $form->getData() instanceof User && $form->getData()->getId()
? ['profile']
: ['registration'];
}
嵌套对象与分组传播
若 User 包含 Address 对象，且 Address 也有分组约束，可在 User 中用 @Assert\Valid 并指定 groups：
/**
* @Assert\Valid(groups={"registration"})
*/
public $address;
这样验证 User 的 registration 分组时，也会递归验证 Address 中属于 registration 的约束。
