Symfony 6.4 安全处理上传文件需四步：表单设 enctype="multipart/form-data"；控制器用 finfo_open 校验真实 MIME 类型并检查 $file->isValid()；存储至 var/uploads/ 并重命名 UUID+白名单扩展名；通过受控路由（如 DownloadController::show）校验权限后流式响应。
Symfony 6.4 接收上传文件本身很简单，但真正安全、可用的处理需要兼顾表单配置、控制器逻辑、类型校验和存储路径设计。跳过任一环节都可能引发空文件、类型绕过或远程代码执行等风险。
确保表单正确提交文件
HTML 表单必须显式声明 enctype="multipart/form-data"，否则 $request->files 始终为空，后续所有操作都会静默失败。
- 检查表单是否带该属性：
<form enctype="multipart/form-data" method="POST"> - 若用 Symfony 表单组件，
FileType::class默认已处理编码，但需确认字段名与控制器中获取时一致（如$request->files->get('avatar')中的'avatar'） - 提交后可快速验证：
dump($request->files->get('avatar'))，应返回UploadedFile实例，而非null
在控制器中安全接收并校验
不要直接信任原始文件名或客户端声明的 MIME 类型。必须使用 PHP 的 finfo_open()（即 fileinfo 扩展）基于文件内容识别真实类型。
- 先检查上传状态：
if (!$file->isValid()) { throw new \RuntimeException('上传失败：' . $file->getError()); } - 启用
fileinfo扩展（php -m | grep fileinfo，未启用则在php.ini中取消注释extension=fileinfo） - MIME 白名单建议写在表单约束中（
Assert\File(['mimeTypes' => [...]])），它比控制器里手动判断更规范、可复用
文件名与存储路径必须隔离
绝不能把上传文件直接保存到 public/ 目录——那是 Web 根路径，任何上传的 .php、.phar 或恶意 .htaccess 都会被服务器直接解析执行。
- 推荐存放位置：
%kernel.project_dir%/var/uploads/（Web 服务器默认无法直接访问） - 文件名必须重写：丢弃原始名，用 UUID + 安全扩展名（如
7a3b9c1d-2e4f-5g6h-8i9j-0k1l2m3n4o5p.jpg） - 扩展名必须来自白名单校验后的 MIME 类型映射（例如
image/jpeg → .jpg），不能取自客户端传来的getClientOriginalExtension()
提供安全的文件访问方式
用户要查看或下载上传的文件，不能通过 /uploads/xxx.jpg 这类直链，而应走受控路由，由控制器统一校验权限并流式输出。
- 定义一个控制器方法（如
DownloadController::show()），接收哈希 ID 或数据库 ID - 根据 ID 查数据库获取真实路径、权限、过期时间等元数据
- 用
readfile()或BinaryFileResponse输出内容，并设置合适的响应头（Content-Disposition、Cache-Control等） - 避免暴露物理路径，也避免在 URL 中泄露敏感信息（如用户 ID、原始文件名）
