symfony 5.4 中 vichuploaderbundle 文件映射需三处统一 mapping 名（如 product_image），upload_destination 指定服务器绝对路径（如 public/uploads/product），uri_prefix 匹配 web 可达 url 前缀（如 /uploads/product），并推荐开启 delete_on_update 和 delete_on_remove 自动清理旧文件。
在 Symfony 5.4 中配置 VichUploaderBundle 的文件映射，核心是让实体字段与上传行为、存储路径、命名规则形成明确绑定。它不靠控制器手动处理文件，而是通过注解 + YAML 配置驱动自动流转：表单提交 → 文件保存 → 字段更新 → 旧文件清理。
mapping 名称必须前后一致
mapping 是整个机制的“连接键”，需在三处严格统一：
- 实体类中
@Vich\UploadableField(mapping="product_image")的字符串值 -
config/packages/vich_uploader.yaml中 mappings 下的顶级键名：product_image: - 表单类型中
->add('imageFile')所绑定的虚拟字段名（非数据库字段）也应语义对应
名称本身无限制，但建议用下划线分隔、见名知意（如 user_avatar、post_cover），避免空格或特殊字符。
upload_destination 决定物理存放位置
该路径是服务器上的绝对目录，Bundle 会把文件写入此处。常见写法有：
-
"%kernel.project_dir%/public/uploads/product"—— 推荐，符合 Symfony 5.4+ Web 根目录规范（public/ 替代 web/） -
"%kernel.project_dir%/var/uploads"—— 适合不希望文件被直接 HTTP 访问的场景（需额外配路由或控制器提供下载）
注意：目录需存在且 Web 服务器用户（如 www-data）有写权限；Bundle 不会自动创建父级目录，首次上传前请手动运行 mkdir -p。
uri_prefix 控制前端可访问路径
这是生成 asset() 或 imagine_filter() 时拼接 URL 的前缀，必须与 upload_destination 的 Web 可达路径匹配：
- 若文件存于
public/uploads/product，则uri_prefix: /uploads/product - 若存于
var/uploads，则不能直接设uri_prefix，需配合 LiipImagineBundle 或自定义控制器暴露
错误配置会导致模板中 {{ asset(product.image) }} 返回 404。
delete_on_update 和 delete_on_remove 要按需开启
这两个布尔选项控制旧文件生命周期，避免磁盘堆积：
-
delete_on_update: true→ 编辑时上传新文件，自动删原文件（推荐开启） -
delete_on_remove: true→ 调用$entityManager->remove($entity)并 flush 后，删对应文件（推荐开启）
若关闭，需自行在 preRemove 或 postRemove 事件中处理文件删除逻辑。
