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+。

Linux Ai Server

Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。

下载

• 推荐命令：composer require intervention/image（自动拉取最新稳定版，目前为 v2.x）
• 安装后立即测试：新建 test.php，写入

  <?php
  require 'vendor/autoload.php';
  use Intervention\Image\ImageManager;
  use Intervention\Image\Drivers\Gd\Driver;
  
  $manager = new ImageManager(new Driver());
  $image = $manager->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 实例，再套框架封装。