在 symfony 中集成图片处理需安装 liip/imagine-bundle 和 imagine/imagine，注册 bundle 并配置 filters（如 my_thumb 缩略图），通过 twig 的 imagine_filter 或 asset() 使用，在 public/uploads 下放置原图后执行命令生成缓存至 public/media/cache。
在 Symfony 项目中集成图片处理功能，需要通过官方推荐的 liip/imagine-bundle 绑定 imagine/Imagine 库实现缩略图生成、裁剪、水印等操作，而不是手动安装 Imagine 原生库再自行封装服务。
安装 LiipImagineBundle 和 Imagine 依赖
执行命令安装扩展包和底层图像处理引擎：
composer require liip/imagine-bundle imagine/imagine
这一步必须完成，否则后续所有配置都会因类未加载而报错。Bundle 本身不包含图像处理逻辑，【imagine/imagine 是实际执行 resize/crop/filter 的核心】，缺一不可。
注册 Bundle 并启用配置
打开 config/bundles.php，添加：
Liip\ImagineBundle\LiipImagineBundle::class => ['all' => true],
然后运行命令生成默认配置文件：
php bin/console liip:imagine:cache:resolve assets/images/photo.jpg
该命令会触发 bundle 自动生成 config/packages/liip_imagine.yaml，若文件不存在或为空，说明 Bundle 未正确注册。
定义图片过滤器（filter）
编辑 config/packages/liip_imagine.yaml，在 filters 节点下添加一个名为 my_thumb 的缩略图规则：
filters:
my_thumb:
type: thumbnail
size: [120, 90]
mode: outbound
【mode: outbound 表示只在原图比目标尺寸大时才缩放，避免拉伸小图】。如果误写成 inset 或漏掉 mode，会导致小图被强行拉伸变形，且错误不会在配置校验阶段暴露。
在 Twig 模板中使用图片过滤器
方法一：直接用 imagine_filter 过滤器输出 URL
方法二：配合 asset() 函数（仅当图片路径由 Webpack Encore 或传统 public/ 目录托管时有效）
%7Cimagine_filter('my_thumb')%20%7D%7D)
注意：第一种写法要求图片路径是相对于 public/ 的相对路径，且不能以 / 开头；第二种写法要求路径已通过 asset() 解析为可访问 URL，否则生成的链接会 404。
手动触发图片缓存生成
第一步：确认原始图片已放在 public/uploads/photo.jpg
第二步：执行命令生成对应缩略图缓存文件：
php bin/console liip:imagine:cache:resolve uploads/photo.jpg --filter=my_thumb
第三步：检查 public/media/cache/my_thumb/uploads/photo.jpg 是否生成了新文件
这一步跳过会导致首次访问页面时触发同步处理，拖慢响应速度。缓存目录默认位于 public/media/cache，【不要手动删除该目录下的子目录，否则下次请求会重新生成全部缓存】。
