直接运行 composer require imagine/imagine 即可安装最新稳定版（v1.x），它不依赖 Laravel 或 Symfony，纯 PHP 图像处理库，支持 GD、Imagick、Gmagick 三种驱动。
Composer 安装 imagine/imagine 的正确命令
直接运行 composer require imagine/imagine 即可安装最新稳定版（v1.x）。它不依赖 Laravel 或 Symfony，纯 PHP 图像处理库，支持 GD、Imagick、Gmagick 三种驱动。
常见错误是误敲成 composer require imagine（包名不全），会报 Could not find package imagine；也有人写成 imagine/imagine-library，实际官方包名就是 imagine/imagine。
如果项目已禁用 Packagist 默认源，需确认是否配置了可信镜像源（如阿里云或腾讯云 Composer 镜像），否则可能卡在 Loading composer repositories。
加载类与初始化 Imagine 实例的写法
安装后无需手动 require，只要项目启用了 Composer 自动加载（即有 vendor/autoload.php），就能直接 new 实例。
关键点在于驱动选择：默认构造函数不自动探测扩展，必须显式传入驱动对象：
- 用 GD：需要
ext-gd已启用，代码为new Imagine\Gd\Imagine() - 用 Imagick：需
ext-imagick，代码为new Imagine\Imagick\Imagine() - 用 Gmagick：较少见，对应
new Imagine\Gmagick\Imagine()
没传驱动或扩展未启用时，会抛出 ExtensionMissingException，不是 Fatal Error，但容易忽略异常捕获。
基础图像操作示例：缩放 + 保存
以下是最常用的一段实操代码，注意路径、格式、权限三处易错点：
$imagine = new Imagine\Gd\Imagine();
$image = $imagine->open('/path/to/input.jpg');
$size = $image->getSize();
$resized = $image->thumbnail($size->scale(0.5), Imagine\Image\ImageInterface::THUMBNAIL_INSET);
$resized->save('/path/to/output.jpg', ['quality' => 90]);
说明：
-
thumbnail()第二个参数决定裁剪/缩放策略：THUMBNAIL_INSET等比缩放不裁剪，THUMBNAIL_OUTBOUND填满目标尺寸并裁剪 - 保存路径必须有写权限，且父目录存在；否则报
Unable to write image - JPEG 质量值范围是 0–100，但
quality选项只对 JPEG/BMP 有效，PNG 忽略该参数
GD 与 Imagick 驱动的实际差异
不是“装了就能用”，得看具体需求：
- 透明 PNG 处理：GD 对 alpha 通道支持弱，常出现黑边；Imagick 默认保留完整透明度
- WebP 支持：GD ≥ 8.1 才原生支持读写 WebP；Imagick 从 3.4.0+ 开始稳定支持
-
内存占用：大图（如 5000×3000）用 GD 易触发
Allowed memory size exhausted；Imagick 更省内存但需额外扩展 - 旋转/翻转精度：GD 使用整数坐标，多次旋转会累积失真；Imagick 使用浮点运算，精度更高
生产环境建议先检查 extension_loaded('imagick')，再 fallback 到 GD，而不是硬编码一种驱动。
