spatie\image\image 可直接从 uploadedfile 加载压缩，避免 move() 后临时文件被删导致失败；需用 getrealpath() 或传 $file 实例，optimize(1–100) 统一控制质量，resize()/fit() 保证等比缩放，webp 需手动指定后缀及 mime 类型。
直接用 Spatie\Image\Image 从 UploadedFile 加载并压缩，比先存盘再处理快 30% 以上，且避免临时文件被清理导致的 Unable to read image from file 错误。
为什么不能先 move() 再压缩？
PHP 上传机制会在请求结束时自动清理 $_FILES 对应的临时文件。一旦调用 $file->move() 或甚至只是读取过 $file->getPathname()，后续再用该路径传给图像库（如 Intervention\Image）就可能失败——尤其在 Swoole、Octane 或高并发场景下，临时文件早已被删。
- ✅ 正确做法：用
$file->getRealPath()（返回真实路径且保证未删）或直接传$file实例（Spatie\Image原生支持） - ❌ 避免写
Image::make($file->getPathname())—— 这个路径不稳定 - ⚠️
Intervention\Image传UploadedFile对象也能工作，但需确保底层驱动（GD/Imagick）已启用，否则静默失败
Spatie\Image 压缩质量与尺寸控制要点
它不依赖配置文件，所有参数都在代码里显式控制，适合动态策略（比如广告图压到 75%，头像压到 90%）。
- 质量必须用
optimize()而非quality()：Image::load($file)->width(800)->height(600)->optimize(75)->save($path) -
optimize()参数是整数（1–100），对 JPEG/PNG/WebP 都生效；quality()仅部分格式支持，且行为不一致 - 缩放优先用
resize()（等比）或constrain()（限最大宽高），别用width()/height()单独设——会拉伸变形 - WebP 输出需手动指定后缀：
save($path . '.webp')，否则默认仍输出 JPEG
Intervention\Image 模糊/黑边常见修复
不是压缩本身的问题，而是图像元数据和插值算法没处理好。
- 模糊主因：GD 驱动默认用
IMG_NEAREST_NEIGHBOR插值，加->interpolate(\Intervention\Image\Enums\Interpolation::BICUBIC)可明显改善（仅 Imagick 支持 BICUBIC；GD 只能选BILINEAR） - 黑边/裁偏：手机拍的图带 EXIF 方向信息，必须
->orientate()再裁剪，否则crop(300, 300, 100, 100)可能裁到空白区 - 居中裁剪固定尺寸，直接用
->fit(300, 300, 'center', 'center')，它内部已处理坐标对齐和 overflow - 若用 GD 驱动且发现压缩后颜色异常，检查是否启用了
imagealphablending(false)和imagesavealpha(true)（尤其 PNG 透明通道）
真正容易被忽略的是：不同图像库对 WebP 的 MIME 头处理不一致。用 Spatie\Image 生成的 WebP 文件，如果 Nginx 没配 image/webp 类型，浏览器会下载而非显示；而 Intervention\Image 的 encode('webp') 默认不设响应头，需手动加 header('Content-Type: image/webp') 才能正确预览。
