应使用加密安全的随机标识符（如bin2hex(random_bytes(16))）生成唯一文件名，结合finfo_file校验的真实mime类型映射白名单扩展名，按哈希分层存储于非公开目录。
在 Symfony 6.4 中实现上传文件自动重命名，核心目标是**消除原始文件名带来的安全与冲突风险**，而非简单拼接时间戳或序号。原始名不可信（含路径遍历、非法字符、编码问题），且直接使用易导致覆盖、注入或存储异常。推荐采用「唯一标识 + 安全扩展名」组合策略，全程由 PHP 控制，不依赖用户输入。
生成唯一文件名的可靠方式
不用 date()、microtime() 或 rand()，它们无法保证全局唯一，尤其在高并发或分布式场景下极易重复。应使用加密安全的随机标识符：
- 用 bin2hex(random_bytes(16)) 生成 32 位小写十六进制字符串（如
7a2b8c1d3e4f5g6h7i8j9k0l1m2n3o4p） - 或用 Ulid::generate()（需安装
ramsey/ulid）—— 时间有序、无碰撞、更短更可读 - 避免 UUID v4（含连字符和大小写），增加处理成本；也不建议仅用
uniqid()，它不加密安全且可能重复
保留并校验真实扩展名
不能信任客户端传来的 $_FILES['file']['name'] 或 UploadedFile::getClientOriginalExtension()，它们可被伪造。正确做法是：
- 用 finfo_file() 检测文件真实 MIME 类型，再映射为白名单内的安全扩展名（如
image/jpeg → .jpg，application/pdf → .pdf） - 丢弃原始扩展名，只取白名单中对应的一个（例如即使上传的是
report.PDF或shell.php.jpg，最终都存为abc123.pdf） - 扩展名必须小写、不含点号前缀，且长度限制在 4 字符以内（防超长或控制字符）
构造最终存储路径与文件名
完整文件名 = 唯一 ID + 安全扩展名；路径建议按哈希分层，提升海量文件时的 I/O 效率：
- 例如：将
7a2b8c1d3e4f5g6h7i8j9k0l1m2n3o4p.jpg存入var/uploads/7a/2b/7a2b8c1d3e4f5g6h7i8j9k0l1m2n3o4p.jpg - 子目录名取唯一 ID 前两位（
7a）、再两位（2b），避免单目录文件过多 - 确保
var/uploads不在public/下，且 Web 服务器禁止直接访问该目录
代码片段示意（控制器内）
无需第三方包，纯 Symfony + PHP 原生能力即可完成：
（注意：此逻辑应在验证通过、移动前执行）$originalFile = $request->files->get('avatar');<br>$finfo = finfo_open(FILEINFO_MIME_TYPE);<br>$realMime = finfo_file($finfo, $originalFile->getPathname());<br>finfo_close($finfo);<br><br>// 白名单映射<br>$mimeMap = [<br> 'image/jpeg' => '.jpg',<br> 'image/png' => '.png',<br> 'application/pdf' => '.pdf',<br>];<br>$ext = $mimeMap[$realMime] ?? '.bin'; // 默认兜底<br><br>$uniqueId = bin2hex(random_bytes(16));<br>$safeName = $uniqueId . $ext;<br>$subDir = substr($uniqueId, 0, 2) . '/' . substr($uniqueId, 2, 2);<br>$targetPath = $this->getParameter('kernel.project_dir') . '/var/uploads/' . $subDir;<br>mkdir($targetPath, 0755, true);<br><br>$originalFile->move($targetPath, $safeName);
