intervention image需先启用gd或imagick扩展，再通过composer安装并显式配置驱动；等比缩放用resize(宽,null,upsize())，裁剪用fit()或crop()；webp保存需encode('webp',质量)；生产环境应缓存缩略图避免重复处理。
直接用 composer require intervention/image 装不上就别硬试了——它依赖系统级图像扩展，没配好 GD 或 Imagick，装完也跑不起来。
确认 PHP 图像扩展已启用
Intervention Image 不是纯 PHP 库，它只是封装层，底层必须有 gd 或 imagick 扩展可用。运行 php -m | grep -E "(gd|imagick)" 查看是否加载。常见坑：Docker 环境里默认没装 php-gd，Ubuntu/Debian 需额外执行 apt-get install php-gd 并重启 PHP-FPM；Mac 用 Homebrew 装 PHP 时，得手动加 --with-gd 或装 php@8.2-gd（版本对齐）。
安装 Intervention Image 及适配驱动
先装包：composer require intervention/image。接着在代码里显式指定驱动，否则可能报 Class 'Imagick' not found 或静默 fallback 到 GD 但不报错——这会导致某些格式（如 WebP 写入）失败。推荐写法：
$image = Intervention\Image\Facades\Image::make($path);
$image->resize(800, null, function ($constraint) {
$constraint->aspectRatio();
});
但前提是已在 Laravel 的 config/app.php 中注册服务提供者（Laravel 10+ 已弃用自动发现，必须手动加）；非 Laravel 项目则必须初始化驱动：
- 用 GD：
Intervention\Image\ImageManager::configure(['driver' => 'gd']) - 用 Imagick：
Intervention\Image\ImageManager::configure(['driver' => 'imagick'])
动态裁剪与缩放的典型写法及陷阱
缩放时传 null 表示按比例自动计算，但 resize(800, 600, function ($c) { $c->aspectRatio(); }) 这种写法实际无效——aspectRatio() 只在 fit() 或 crop() 中起作用。正确做法：
- 等比缩放固定宽：
$image->resize(800, null, function ($c) { $c->upsize(); })（加upsize()防止原图更小反而被拉伸） - 居中裁剪成正方形：
$image->fit(300, 300)（自动居中、缩放、裁剪） - 手动指定裁剪区域：
$image->crop(300, 300, 50, 100)（宽、高、x 偏移、y 偏移）
注意：save() 默认质量是 90（JPEG），WebP 格式需显式传参：$image->encode('webp', 80)->save($path)，否则可能生成空文件或报 MIME 错误。
生产环境缩略图缓存建议
每次请求都实时处理图片会拖慢响应，尤其并发高时。不要自己拼路径做文件存在判断——file_exists() 在 NFS 或容器挂载卷上性能极差。推荐用 Laravel 的 Storage::disk('public')->exists()（底层走 Flysystem 缓存），或更干脆：用 spatie/laravel-image-optimizer 配合 CDN URL 重写规则，让 Nginx 直接 serve 已生成的缩略图。真正的难点不在怎么裁，而在怎么避免重复裁。
