Symfony文件验证通过File约束实现，支持maxSize、mimeTypes和extensions三项校验，需显式配置参数并安装symfony/mime组件以确保MIME类型安全校验。
Symfony 文件验证主要通过 File 约束实现，适用于表单上传或手动校验 UploadedFile 对象，核心是控制大小、MIME 类型、后缀等安全边界，不依赖 Doctrine 或实体注解，需单独配置并注意依赖安装。
基础文件约束：大小与类型控制
File 约束支持三项关键校验，必须显式传入参数，否则默认不生效：
-
maxSize：限制文件体积，支持单位如
'2M'、'1024k'、'5000000'（字节）；超限触发maxSizeMessage -
mimeTypes：指定允许的 MIME 类型数组，例如
['image/jpeg', 'image/png']；匹配失败时用mimeTypesMessage -
extensions：白名单后缀（小写），如
['pdf', 'docx']；注意它只校验扩展名，不解析内容，安全性弱于 MIME 校验
示例（手动验证）：
use Symfony\Component\Validator\Constraints\File;
use Symfony\Component\Validator\Validation;
$constraints = new File([
'maxSize' => '8M',
'mimeTypes' => ['application/pdf', 'application/msword'],
'maxSizeMessage' => '文件不能超过 8MB',
'mimeTypesMessage' => '仅支持 PDF 和 Word 文档'
]);
$validator = Validation::createValidator();
$errors = $validator->validate($uploadedFile, $constraints);
集成到表单：绑定约束更简洁
在 FormType 中直接为文件字段添加约束，比手动验证更符合 Symfony 流程：
- 字段类型设为
FileType::class - 在
configureOptions或buildForm中，用constraints选项注入File实例 - 表单提交后调用
$form->isValid()即自动触发校验
示例（FormType）：
use Symfony\Component\Form\Extension\Core\Type\FileType;
use Symfony\Component\Validator\Constraints\File as FileConstraint;
$builder->add('document', FileType::class, [
'constraints' => [
new FileConstraint([
'maxSize' => '4M',
'mimeTypes' => ['text/csv'],
])
]
]);
依赖与注意事项
File 约束依赖 symfony/mime 组件解析真实 MIME 类型，否则 mimeTypes 会退化为扩展名匹配：
- 运行
composer require symfony/mime安装该包 - 若未安装，
mimeTypes仍能工作，但仅基于客户端提交的扩展名和 HTTP 头，易被绕过 -
UploadedFile对象必须来自$request->files->get('field_name')，不能传路径字符串或资源句柄 - 验证前确保文件已成功上传（
$file->isValid() === true），否则约束可能跳过或报错
进阶：自定义文件验证逻辑
当内置约束不够用（如校验 PDF 内容是否含文字、图片分辨率是否达标），可用 Callback 或自定义 Constraint：
- 在实体或 DTO 中添加
@Assert\Callback方法，接收ExecutionContextInterface $context - 方法内调用
$file->getPathname()获取临时路径，用原生 PHP 函数（如exif_imagetype()、finfo_open()）做深度检测 - 校验失败时调
$context->buildViolation('错误信息')->atPath('fieldName')->addViolation()
注意：临时文件在请求结束时会被自动删除，务必在校验逻辑中完成所有读取操作。
