Intervention Image 必须通过 Composer 安装并确保 PHP 启用 GD 或 Imagick 扩展，否则运行时报 Class not found 或 Unsupported driver 错误；Laravel 9/10 需手动注册服务提供者和门面，Laravel 11+ 则必须使用 ImageManager 实例。
Intervention Image 必须通过 Composer 安装，且需注意 PHP 版本、GD 或 Imagick 扩展是否启用——没装扩展的话，composer require intervention/image 能成功，但运行时会直接报 Class 'Intervention\Image\ImageManager' not found 或 Unsupported driver [gd] 错误。
确认 PHP 环境已启用 GD 或 Imagick 扩展
Intervention Image 依赖底层图像驱动，不装扩展就无法实例化图片对象。Windows 用户常漏掉这步，Linux/macOS 用户也容易因 PHP 多版本共存导致 CLI 和 Web 使用的 php.ini 不一致。
- 运行
php -m | grep -i gd（Linux/macOS）或php -m（Windows，手动查找gd或imagick）确认扩展已加载 - 若用 XAMPP/MAMP，检查对应控制面板里 PHP 扩展是否勾选；Docker 用户需在
Dockerfile中显式安装php-gd或php-imagick - 扩展启用后，
phpinfo()页面中应能看到gd或imagick模块信息，且Configure Command行包含--with-gd或--with-imagick
执行 Composer 安装并验证基础可用性
安装命令本身很简单，但要注意 Laravel 与原生 PHP 项目的配置差异。Laravel 9+ 默认使用 PHP 8.0+，而 Intervention Image 的 v2 分支支持 PHP 8，但旧版 v1（如 intervention/image:2.4）已停止维护且不兼容 PHP 8.2+。
- 推荐命令：
composer require intervention/image（自动拉取最新稳定版，目前为 v2.x） - 安装后立即测试：新建
test.php，写入read('test.jpg'); // 确保当前目录有 test.jpg echo $image->toJpeg()->toString();若输出乱码（即 JPEG 二进制内容），说明驱动工作正常 - 若报错
Unsupported driver [gd]，不是扩展问题，而是用了过时的初始化方式（如Image::make()），v2 必须用ImageManager+ 显式传入Driver
Laravel 项目中如何注册服务提供者和门面（Laravel ≤ 10）
Laravel 11+ 已移除自动发现和服务提供者注册机制，但多数线上项目仍在用 Laravel 9/10，此时需手动配置——否则 Image 门面无法解析，调用 Image::make() 会提示 Class 'Image' not found。
- 编辑
config/app.php，在'providers'数组末尾添加：Intervention\Image\ImageServiceProvider::class,
- 在同一文件的
'aliases'数组中添加：'Image' => Intervention\Image\Facades\Image::class,
- 运行
php artisan config:clear清缓存，否则新增配置不生效 - 注意：Laravel 11 开始不再支持
Image门面，必须改用ImageManager实例，例如在控制器中use Intervention\Image\ImageManager; use Intervention\Image\Drivers\Gd\Driver;后new ImageManager(new Driver())
真正卡住人的往往不是安装命令，而是驱动未启用、Laravel 版本错配门面、或 PHP CLI 与 Web SAPI 加载了不同配置——建议先跑通最简 ImageManager 实例，再套框架封装。
