Symfony 7.1 中文件上传后图片压缩应嵌入上传流程，在写入磁盘前完成尺寸调整与质量优化；推荐 VichUploaderBundle + LiipImagineBundle 组合，支持自动路径管理与缓存化压缩，或纯 PHP 手动压缩及前端预压缩协同优化。
Symfony 7.1 中实现文件上传后的图片压缩，关键不是“先存再压”，而是把压缩逻辑嵌入到上传流程中——在文件写入磁盘前完成尺寸调整与质量优化，避免冗余IO和临时文件堆积。下面给出一套轻量、可维护、适配现代 Symfony 架构的集成方案。
用 VichUploaderBundle + ImagineBundle 组合处理
这是目前 Symfony 社区最主流、文档最完善、与 7.1 兼容良好的组合：
- VichUploaderBundle 负责统一管理实体字段与上传行为（支持本地、Flysystem、S3等），自动处理临时文件移动、命名、路径生成；
- LiipImagineBundle（基于 PHP Imagine 库）专注图像变换，支持缩放、裁剪、水印、格式转换和质量可控的 JPEG/PNG 压缩，且支持缓存预生成。
安装方式（推荐使用 Composer）：
composer require vich/uploader-bundle liip/imagine-bundle
配置示例（config/packages/vich_uploader.yaml）：
vich_uploader:
db_driver: orm
mappings:
product_image:
uri_prefix: /uploads/images
upload_destination: '%kernel.project_dir%/public/uploads/images'
namer: vich_uploader.namer_uniqid
在实体中绑定上传字段并声明 imagine filter：
#[Vich\Uploadable]
class Product
{
#[Vich\UploadableField(mapping: 'product_image', fileNameProperty: 'imageName')]
public ?File $imageFile = null;
<pre class="brush:php;toolbar:false;">#[ORM\Column(type: 'string', nullable: true)]
public ?string $imageName = null;
// getter/setter...}
定义压缩 filter（config/packages/liip_imagine.yaml）：
liip_imagine:
resolvers:
default:
web_path: ~
filter_sets:
compressed_web:
quality: 75
format: jpeg
filters:
thumbnail: { size: [1200, 800], mode: outbound }
strip: ~
上传后，调用 $imagine->getFilterResponse('compressed_web', $filePath) 即可获得压缩后响应，或通过 URL 自动触发（如 /media/cache/resized/image.jpg）。
纯 PHP 实现（无 Bundle，适合轻量项目）
若不想引入额外依赖，可借助 Symfony 的 UploadedFile 和原生 GD 或 Imagick 扩展手动压缩：
- 接收上传后，用
$uploadedFile->move()先暂存为原始图； - 读取该文件，创建缩略图并设置 JPEG 质量（60–80）、PNG 压缩级别（
imagepng($img, null, 9)）； - 覆盖原图或另存为新文件，再清理原始临时副本。
注意：需确保 PHP 启用了 gd 或 imagick，并在 php.ini 中开启 fileinfo 支持 MIME 类型校验。
前端配合：上传前轻量压缩（可选增强）
服务端压缩无法规避大图上传耗时。建议在用户选择图片后，用 JavaScript（如 compressorjs 或 browser-image-compression）做一次客户端预压缩：
- 限制最大宽度/高度（如 2400px）；
- JPEG 质量设为 70–80；
- PNG 自动转为 JPEG（若无透明需求）；
- 返回 Blob 后再通过 FormData 提交。
这样既减轻服务器压力，又缩短用户等待时间，与 Symfony 后端形成完整链路。
环境变量驱动压缩策略
不同环境应有不同压缩强度：开发环境保留高清便于调试，生产环境激进压缩节省带宽。利用 Symfony Dotenv 组件统一管理：
# .env IMAGE_COMPRESSION_QUALITY=85 IMAGE_MAX_WIDTH=1920 IMAGE_FORMAT_FALLBACK=jpeg
在服务中注入 ParameterBagInterface 读取这些值，动态构建压缩参数，避免硬编码。
