yii2中图片格式转换需手动调用gd或imagick扩展，gd要求jpeg_support、png_support为true，webp需php≥7.4且webp_support=true；png转jpg须铺白底防透明变黑；批量处理需分页+及时释放资源；webp兼容应生成多格式文件并用标签声明。
在Yii2项目中批量将用户上传的JPG转PNG、PNG转WebP或统一降级为JPG时，不能依赖框架内置组件——Yii2本身不提供开箱即用的格式转换服务类，必须调用GD或Imagick扩展手动处理，否则会因透明通道丢失、质量失控或WebP不支持导致线上图片白屏或体积暴增。
确认GD扩展支持目标格式
执行 php -r "var_dump(gd_info());" 检查输出中对应键值：【jpeg_support】 和 【png_support】 必须为 true 才能处理 JPG/PNG；【webp_support】 从 PHP 7.4+ 开始支持，但需编译时启用 --with-webp 参数，否则 imagecreatefromwebp() 会直接报错失败。
若 webp_support 为 false，改用 Imagick（需额外安装）或放弃 WebP 转换路径。
GD方式安全转换PNG→JPG（带白底合成）
这一步操作起来很简单，直接把文件拖进去就行。但PNG含透明通道，直接 imagejpeg() 会导致透明区域变黑，必须手动铺白底。
① 用 imagecreatefrompng($src) 加载源图，返回资源失败则抛出异常；
② 获取宽高 imagesx($image) 和 imagesy($image)，创建同尺寸真彩色画布 imagecreatetruecolor($width, $height)；
③ 用 imagefill($bg, 0, 0, imagecolorallocate($bg, 255, 255, 255)) 填充白色背景；
④ 执行 imagecopy($bg, $image, 0, 0, 0, 0, $width, $height) 将PNG图层复制到白底上；
⑤ 调用 imagejpeg($bg, $dst, 85) 保存，质量设为85是视觉与体积的合理平衡点；最后销毁两个图像资源。
GD方式转换JPG→WebP（需PHP ≥7.4且webp_support=true）
方法一：直接读取再写入（适用于无Alpha通道的纯JPG）
$img = imagecreatefromjpeg($src); imagepalettetotruecolor($img); imagewebp($img, $dst, 80); imagedestroy($img);
方法二：带错误兜底的健壮写法（推荐）
先判断 function_exists('imagewebp')，再检查 gd_info()['webp_support']；若任一不满足，直接返回 false 或抛出 InvalidArgumentException；成功后务必用 imagedestroy() 释放内存，否则批量处理时极易触发内存溢出。
批量转换多张图片（避免内存崩溃）
不要一次性加载全部图片进内存——GD图像资源不释放会持续累积，100张1MB的PNG可能吃光512MB内存。
使用分页+循环处理：每次只取50张路径（如从数据库查 limit 50 offset $offset），处理完立即 unset($image) 并调用 gc_collect_cycles() 强制垃圾回收；
前端用 AJAX 触发下一批，例如点击“继续转换”按钮时传入新的 offset，防止超时中断；
每张图单独 try-catch 包裹，单张失败不影响后续流程，日志记录具体文件名和错误信息。
WebP降级兼容方案（服务端不检测Accept头）
别在控制器里解析 $_SERVER['HTTP_ACCEPT'] 来动态返回 WebP——CDN 缓存会混乱，老浏览器请求可能被缓存成 WebP 导致无法显示。
正确做法：生成三份文件（a.jpg / a.webp / a.png），在 Yii2 视图中用
<picture><source srcset="a.webp" type="image/webp"><source srcset="a.png" type="image/png"><img src="a.jpg" alt="..."></source></source></picture>
浏览器自动选择第一个支持的格式，无需PHP参与协商逻辑。
