直接运行 composer require imagine/imagine 即可安装，包名必须为 imagine/imagine；安装后需显式指定 GD 或 Imagick 驱动，注意 thumbnail() 第二参数决定缩放逻辑，保存路径须有写权限，GD 与 Imagick 在透明通道处理、功能和性能上差异显著。
直接运行 composer require imagine/imagine 就能装好，别敲错包名，也别漏掉 /imagine 后缀。
为什么 composer require imagine 会失败
常见错误是只输 imagine，结果报 Could not find package imagine。官方包名就是 imagine/imagine，不是 imagine、imagine-library 或 php-imagine。
- 确认当前目录是项目根目录（有
composer.json） - 如果公司内网禁用了 Packagist，默认源加载会卡在
Loading composer repositories；需提前配置可信镜像，例如阿里云：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 安装成功后，
vendor/imagine/imagine目录会出现，且autoload.php已自动注册，无需手动require
装完不能直接 new，得选驱动
Imagine 不自动探测 GD 或 Imagick 扩展，必须显式传入驱动对象，否则抛 ExtensionMissingException（不是 Fatal Error，容易被 try/catch 漏掉）。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用 GD：确保
ext-gd已启用，代码为new Imagine\Gd\Imagine() - 用 Imagick：需
ext-imagick，代码为new Imagine\Imagick\Imagine() - 检查扩展是否生效：运行
php -m | grep -i gd（Linux/macOS）或php -m（Windows）看输出里有没有gd或imagick - Docker 或多 PHP 版本环境，注意 CLI 和 Web 使用的
php.ini可能不同
thumbnail() 的第二个参数决定缩放逻辑
这个参数不是可选的默认值，不传会报错；它控制图像如何适配目标尺寸，行为差异很大：
-
Imagine\Image\ImageInterface::THUMBNAIL_INSET：等比缩放，不裁剪，完整显示原图内容（适合头像、预览图） -
Imagine\Image\ImageInterface::THUMBNAIL_OUTBOUND：填满目标尺寸，超出部分居中裁剪（适合封面、卡片图） - 保存时路径必须存在且有写权限，否则报
Unable to write image JPEG -
quality参数只对 JPEG/BMP 生效，PNG 忽略；值范围是 0–100，但设成 100 不代表文件最大，GD 渲染 PNG 仍可能丢 alpha 通道
GD 和 Imagick 驱动的实际区别不止是“能不能用”
选错驱动会导致视觉问题，尤其在处理透明 PNG 时：
- GD 对 alpha 通道支持弱，常出现黑边或灰底；Imagick 默认保留完整透明度
- Imagick 支持更多色彩空间、ICC 配置和高级滤镜，但内存占用高、启动慢
- GD 更轻量，适合简单缩放/裁剪，但不支持 PDF、WebP 编码等
- 如果你的业务涉及用户上传头像或带透明层的素材，优先测 Imagick；若只是后台批量生成商品缩略图，GD 足够
驱动选择不是一次配置就一劳永逸的事——同一套代码在不同服务器上可能因扩展缺失静默降级，建议在初始化前加 extension_loaded('gd') 或 class_exists('Imagick') 检查，并记录明确错误日志。
