ThinkPHP图片上传压缩方案实现

ThinkPHP上传图片默认不压缩，需手动用GD库重编码实现；thumb()仅生成缩略图，无法有效压缩原图，且不支持质量控制；应封装ImageCompressor服务类，按格式调用imagejpeg()/imagepng()覆盖原文件。

ThinkPHP 图片上传后不压缩，是默认行为；要实现自动压缩，必须手动介入上传流程，不能只靠 move() 或配置项。

为什么 thinkImage 的 thumb() 不适合上传时压缩？

很多人误以为调用 thumb() 就能“压缩”，其实它只是生成缩略图，原图仍完整保留。上传场景真正需要的是：原图被有损压缩、尺寸可控、文件体积显著下降。

• thumb() 默认不改变原图，仅写入新文件，白占磁盘空间
• 若用 thumb($path, $width, $height, 1) 覆盖原图，会丢失原始分辨率信息，且不控制 JPEG 质量（默认 95，几乎无压缩）
• 对 PNG/GIF 等格式，thumb() 不支持质量参数，无法有效减小体积

上传后立即用 imagejpeg() / imagepng() 重写文件

这是最直接、兼容性最好、可控性最强的方式。核心思路：上传成功后，用 GD 手动读取并重编码，再覆盖原文件。

• 先用 $file->move() 保存临时文件，拿到 $realPath
• 根据 pathinfo($realPath, PATHINFO_EXTENSION) 判断格式
• JPEG：用 imagecreatefromjpeg() → imagejpeg($img, $realPath, 75)（75 是推荐质量值，60–85 间权衡清晰度与体积）
• PNG：用 imagecreatefrompng() → imagepng($img, $realPath, 6)（PNG 压缩等级 0–9，6 是较优平衡点）
• 务必在重写前加 imagedestroy($img) 防内存泄漏

避免在控制器里硬写图像处理逻辑

把压缩封装成独立方法或服务类，否则后续维护、复用、单元测试都会出问题。

立即学习“PHP免费学习笔记（深入）”；

• 建议新建 appcommonserviceImageCompressor.php，提供静态方法 compress($filePath, $quality = 75)
• 在上传逻辑中调用：ImageCompressor::compress($savedPath, $quality)，而非散落在控制器里
• 注意判断文件是否存在、是否为图片（exif_imagetype() 比扩展名更可靠）
• 如果项目用了 think-image 扩展包，它底层仍是 GD/Imagick，但封装层屏蔽了质量参数——你依然得绕过它，直操作 GD 函数

WebP 格式支持需额外判断运行环境

ThinkPHP 自身不处理 WebP 编码，能否启用取决于 PHP 编译时是否开启 GD 的 WebP 支持。

• 上线前必须检查 gd_info()['webp support'] 返回 true，否则 imagecreatefromwebp() 和 imagewebp() 会报错
• 用户上传 WebP 时，若服务器不支持，应降级为原图保存，而不是崩溃
• 不要在上传时强制转 WebP：浏览器兼容性差（旧版 Safari/IE 不支持），CDN 缓存策略也更复杂

真正麻烦的不是代码几行，而是每种图片格式的加载失败路径、GD 版本差异、内存限制（大图解码可能超限）、以及并发上传时的文件锁竞争——这些细节不写日志，线上就只能靠猜。