Symfony验证上下文（ExecutionContext）是自定义约束验证器中用于动态添加错误、指定错误路径及访问上下文信息的核心接口，由框架自动注入，不可手动实例化。
Symfony 验证上下文（ExecutionContext）是自定义验证逻辑中用于动态添加错误、访问当前验证对象及上下文信息的核心接口。它不直接“配置”，而是在自定义约束的验证器（Validator）中由框架自动注入，主要用于在运行时决定是否报错、报什么错、报给哪个属性。
什么时候必须用 ExecutionContext
当你写的是自定义约束（比如 @Assert\ValidPassword），且验证逻辑不能仅靠静态规则（如长度、格式）完成时，就需要它。典型场景包括：
- 字段间联动校验（如 “确认密码” 必须等于 “密码”）
- 根据当前用户权限或环境动态跳过/触发某条规则
- 需要把错误加到嵌套属性上（如
user.profile.phone）而非根对象 - 想在验证中读取原始输入值、当前分组（group）、或调用服务（如查数据库）
如何在自定义验证器中获取和使用
以约束类 ValidPassword 和其验证器 ValidPasswordValidator 为例：
1. 在验证器的 validate() 方法中，第二个参数就是 ExecutionContextInterface：
use Symfony\Component\Validator\Constraint;
use Symfony\Component\Validator\ConstraintValidator;
use Symfony\Component\Validator\Context\ExecutionContextInterface;
<p>class ValidPasswordValidator extends ConstraintValidator
{
public function validate($value, Constraint $constraint)
{
if (null === $value || '' === $value) {
return;
}</p><pre class="brush:php;toolbar:false;"> // 使用 ExecutionContext 添加错误
if (!preg_match('/[A-Z]/', $value)) {
$this->context->buildViolation($constraint->mustContainUppercase)
->atPath('plainPassword') // 指定错误归属字段
->addViolation();
}
}}
2. 关键方法说明：
-
buildViolation(string $message)：开始构建一条错误消息 -
atPath(string $path)：指定错误挂载到对象的哪个属性（支持点号路径，如profile.email） -
setParameter(string $name, mixed $value)：传入占位符变量（如{{ limit }}） -
addViolation()：最终提交该错误
常见陷阱与注意事项
• 不要手动 new ExecutionContext —— 它由 Validator 组件在运行时创建并注入；
• 若在验证器中调用了其他服务（如 UserRepository），需通过构造函数依赖注入，不要用 $this->container（非控制器中不可用）；
• atPath() 的路径是相对于当前验证目标的。若验证的是整个对象（如 $user），atPath('email') 就指 $user->email；
• 如果你想让错误显示在表单的某个字段上，确保该字段名与 atPath() 中的名称一致，且实体中存在对应 getter 或 public 属性。
配合验证组与回调验证的扩展用法
当验证逻辑更复杂（例如只在注册时检查邮箱唯一性），可结合验证组和 @Assert\Callback：
/**
* @Assert\Callback(groups={"Registration"})
*/
public function validate(ExecutionContextInterface $context): void
{
if ($this->email && $this->userRepository->exists($this->email)) {
$context->buildViolation('该邮箱已被注册')
->atPath('email')
->addViolation();
}
}
此时 $context 直接作为方法参数传入，无需手动获取，且天然支持当前验证组。
