yii框架本身不内置图片压缩能力，需依赖yii\imagine\image扩展，其实际能力由服务器安装的gd或imagick后端决定；安装后须验证php已加载对应扩展，否则调用会报错。
Yii 框架本身不内置图片压缩能力，得靠 yii\imagine\Image 这个扩展来干活；它只是 Imagick 或 GD 的封装，真正起作用的是你服务器上装的哪个图像处理后端——别指望只装个扩展就自动变快。
安装 yii2-imagine 并确认后端可用
先跑命令装扩展：composer require --prefer-dist yiisoft/yii2-imagine。装完不是万事大吉，得看 PHP 是否加载了 gd 或 imagick 扩展：
-
php -m | grep -i gd或php -m | grep -i imagick能看到对应模块才说明可用 - 如果只装了
yii2-imagine但没装底层扩展，调用Image::thumbnail()会直接报Class 'Imagick' not found或类似 GD 函数不存在的错误 -
imagick支持 WebP、更精细控制质量，但需额外编译；gd更轻量，但不支持 WebP 输出，JPEG 质量参数也只接受整数（0–100）
上传时压缩：用 thumbnail() + quality 参数最稳妥
别在响应里实时压缩用户请求的原始图（比如 /images/abc.jpg），那会卡住 PHP 进程。正确做法是：文件上传成功后，立刻生成压缩版并存盘。
- 用
Image::thumbnail($src, $width, $height)自动缩放+裁剪，再加['quality' => 82]控制 JPEG/PNG 压缩强度 - 注意
$width和$height都填 0 表示“不缩放尺寸，只改质量”，但此时必须确保原图不大；否则光调质量没意义 - GD 下
quality=80是性价比拐点：体积降 30%+，人眼几乎看不出差异；设到 95 以上体积下降微乎其微，反而浪费 CPU - 路径要用
Yii::getAlias('@webroot/path/to/file.jpg')，别传相对路径或 URL，否则thumbnail()读不到文件
远程图片下载后压缩：curl + thumbnail 两步不能颠倒
从 URL 下载图片再压缩，常见错误是把压缩逻辑写在 curl_exec() 之前，或者误用 URL 当作 thumbnail() 的第一个参数——它只认本地文件路径。
- 先用
curl把二进制数据拉下来，fwrite()存成临时文件（比如@webroot/tmp/xxx.jpg） - 再调
Image::thumbnail($localPath, $w, $h)->save($dstPath, ['quality' => 80]) - 别省略
file_exists()检查：重复下载同一 URL 时，跳过已存在的本地文件能省带宽和 I/O - 记得清理临时文件，尤其失败时要
unlink($localPath)，否则磁盘会被撑爆
WebP 降级必须前端配合，PHP 层别硬扛 Accept 头
想让现代浏览器加载 WebP、老浏览器 fallback 到 JPEG，靠 PHP 在服务端根据 $_SERVER['HTTP_ACCEPT'] 判断再输出不同格式，极易出错且破坏 CDN 缓存。
- 正确姿势是：用
yii\imagine\Image同时生成.jpg和.webp两个版本（Imagick 可行，GD 不行） - 在 View 层用
<picture></picture>标签主动提供多源：<source srcset="a.webp" type="image/webp"><img src="a.jpg"></source> - 别给
img标签加loading="lazy"却漏掉width/height，否则 CLS（布局偏移）会拉低 Lighthouse 分数
最难的从来不是调哪个函数，而是决定「在哪一环做」：上传时？CDN 预处理？还是 Nginx image_filter 动态生成？选错环节，再对的代码也白搭。
