先安装 symfony/validator 包：composer require symfony/validator；若用 Symfony 框架需确认 config/packages/validator.yaml 存在且启用；纯 PHP 脚本中须用 ValidatorBuilder::create()->getValidator() 构建验证器。
Symfony Validator 怎么加到项目里
没装 symfony/validator 包，Validator 类根本不存在，连 new ValidatorBuilder() 都会报 Class 'Symfony\Component\Validator\ValidatorBuilder' not found。别急着写规则，先确认依赖在了。
- 用 Composer 装：运行
composer require symfony/validator - 如果项目已用 Symfony 框架（如 6.x+），
validator通常默认启用，但得检查config/packages/validator.yaml是否存在且没被注释掉 - 纯 PHP 脚本中使用，必须手动构建验证器：
ValidatorBuilder::create()->getValidator()，不能直接 new
怎么写一个基础的验证规则（比如邮箱 + 非空）
规则不是写在代码逻辑里硬判断，而是绑定在类属性上，靠注解、PHP 属性或 YAML 定义。最常用的是 PHP 属性（PHP 8.1+）或注解（旧版）。
- 定义 DTO 类，用
#[AssertEmail]和#[AssertNotBlank]标记属性（注意命名空间是SymfonyComponentValidatorConstraints） - 验证前要先获取
ValidatorInterface实例，调用$validator->validate($dto) - 返回的是
ConstraintViolationListInterface，不是布尔值；空列表才代表通过，别直接if ($violations)当真值判断
use SymfonyComponentValidatorConstraints as Assert;
<p>class UserInput
{</p><h1>[AssertNotBlank]</h1><pre class="brush:php;toolbar:false;">#[AssertEmail]
public string $email;}
$dto = new UserInput(); $dto->email = 'invalid-email'; $violations = $validator->validate($dto); // $violations->count() === 1 → 有错
验证失败时怎么拿到具体错误信息
ConstraintViolationListInterface 不是数组，不能用 foreach 直接遍历出字符串。每个 ConstraintViolationInterface 对象要手动提取字段名、错误消息、非法值。
- 用
$violation->getPropertyPath()得到字段路径（如email） - 用
$violation->getMessage()拿提示文本（默认是英文，要中文得配翻译域或自定义 message） - 用
$violation->getInvalidValue()查看实际传进来的脏数据（比如'abc'被当成邮箱校验失败） - 别漏掉嵌套对象：如果 DTO 里有子对象并加了
#[AssertValid]，错误路径会是profile.name这种格式
为什么 validate() 总是返回空？常见漏点
不是代码没跑，是验证器根本没“看到”你的约束。最容易忽略的三个地方：
- DTO 类属性是
public？如果是private或protected，默认只校验 public 属性 —— 必须加#[Assert*]在 getter 方法上，或配置enable_annotations: true并确保用了@Assert*注解（非属性） - 用了 PHP 属性但 PHP 版本 /** @AssertNotBlank */）并开启注解解析
- 验证对象是数组或 stdClass？
validate()只接受对象实例，数组得包装成对象，或改用validateProperty()单字段校验
验证这事，90% 的“不生效”不是逻辑错，是约束没挂对位置、没被扫描到、或者对象本身不符合校验入口要求。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
