在 symfony 6.2 中，控制器需先通过表单绑定或 $request->files->get() 获取 uploadedfile 实例，校验非空及上传成功后调用 getclientoriginalname() 获取原始文件名，注意该值不可信，须配合扩展名校验并重命名后存储。
在 Symfony 6.2 中，控制器里获取上传文件的原始名称（即用户选择文件时显示的名称，如 report.pdf），关键在于先正确提取 UploadedFile 实例，再调用其 getClientOriginalName() 方法。
确保已成功获取 UploadedFile 实例
不能直接从请求体或表单数据中“读字符串”，必须通过 Symfony 的文件上传机制拿到对象：
- 如果是标准表单提交（
enctype="multipart/form-data"），推荐用表单组件绑定：在控制器中执行$form->handleRequest($request)，验证通过后从表单数据中取字段值，例如$data['file']—— 它应是Symfony\Component\HttpFoundation\File\UploadedFile实例。 - 如果是 AJAX 或自定义上传（如 Dropzone），需手动提取：
$file = $request->files->get('file');，其中'file'是前端<input type="file" name="file">的 name 属性值。 - 务必检查
$file instanceof UploadedFile且$file->getError() === UPLOAD_ERR_OK，避免空值或上传失败时调用方法报错。
调用 getOriginalFileName() 获取原始名称
拿到有效的 UploadedFile 对象后，直接调用：
$originalName = $file->getClientOriginalName();
该方法返回的是客户端提交的原始文件名（含扩展名），例如 "财务报表_Q3.xlsx"。注意：
- 这个值由浏览器提供，**不可信任**，不能直接用于保存路径（防
../路径遍历）； - 它不经过任何服务器端重命名或清理，可能含空格、中文、特殊符号甚至控制字符；
- 若需安全存储，应配合
getClientOriginalExtension()提取扩展名，并用哈希或时间戳生成新文件名。
常见错误与规避方式
以下操作容易导致获取失败或结果异常：
- 误用
$request->get('file')—— 这会返回 null 或字符串，不是 UploadedFile 对象； - 未校验
$file是否存在就调用方法，抛出Call to a member function getOriginalName() on null； - 混淆
getClientOriginalName()和getClientOriginalExtension()：后者只返回扩展名（如'pdf'），前者是完整名称； - 在
$file->move()后再尝试获取原始名 —— move 不影响原始名属性，仍可调用，但逻辑上应在 move 前完成校验和重命名准备。
