Laravel 10调用Intervention\Image报错：GD Driver类未找到

问题 #

在Laravel 10项目中安装intervention/image 3.5版本后，运行时出现错误：

Class "Intervention\Image\Drivers\GD\Driver" not found

对应的代码片段：

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\GD\Driver;

class GetImageProps
{
    public static function get(string $imageType, string $imagePath = null): array
    {
        $retArray = [];
        $storageFullImagePath = base_path() . '/storage/app/' . $imagePath;
        try {
            $manager = new ImageManager(new Driver()); // Error pointing this line
            $targetImage = $manager->read($storageFullImagePath);

已确认包安装正常，执行composer show intervention/image输出如下：

$ composer show intervention/image
name     : intervention/image
descrip. : PHP image manipulation
keywords : gd, image, imagick, resize, thumbnail, watermark
versions : * 3.5.0
type     : library
license  : MIT License (MIT) (OSI approved) https://spdx.org/licenses/MIT.html#licenseText
homepage : https://image.intervention.io/
source   : [git] https://github.com/Intervention/image.git 408d3655c7705339e8c79731ea7efb51546cfa10
dist     : [zip] https://api.github.com/repos/Intervention/image/zipball/408d3655c7705339e8c79731ea7efb51546cfa10 408d3655c7705339e8c79731ea7efb51546cfa10
path     : /mnt/_work_sdb8/wwwroot/lar/NewsPublisher/vendor/intervention/image
names    : intervention/image

support
issues : https://github.com/Intervention/image/issues
source : https://github.com/Intervention/image/tree/3.5.0

autoload
psr-4
Intervention\Image\ => src

requires
ext-mbstring *
intervention/gif ^4.0.1
php ^8.1

requires (dev)
mockery/mockery ^1.6
phpstan/phpstan ^1
phpunit/phpunit ^10.0
slevomat/coding-standard ~8.0
squizlabs/php_codesniffer ^3.8

suggests
ext-exif Recommended to be able to read EXIF data properly.

phpinfo显示GD扩展已启用：

PHP Version 8.2.16

gd
GD Support  enabled
GD headers Version  2.3.3
GD library Version  2.3.3
FreeType Support    enabled

请问是否需要在config/app.php中配置相关选项？问题出在哪里？

解决方案 #

问题根源 #

Intervention Image 3.x版本的GD驱动类命名空间已变更，你使用的Intervention\Image\Drivers\GD\Driver是旧版（2.x）的命名方式，3.x中正确的GD驱动类路径是Intervention\Image\Drivers\Gd\Driver（注意是小写的Gd，不是大写的GD）。

修复步骤 #

1. 修正命名空间引用
   将代码中的use语句和实例化代码修改为：

   use Intervention\Image\ImageManager;
   use Intervention\Image\Drivers\Gd\Driver; // 改为小写Gd
   
   class GetImageProps
   {
       public static function get(string $imageType, string $imagePath = null): array
       {
           $retArray = [];
           $storageFullImagePath = base_path() . '/storage/app/' . $imagePath;
           try {
               $manager = new ImageManager(new Driver()); 
               $targetImage = $manager->read($storageFullImagePath);
   

2. 简化实例化方式（可选）
   3.x版本支持直接传入驱动名称字符串初始化ImageManager，无需手动实例化Driver类，代码更简洁：

   $manager = new ImageManager('gd');
   

3. 无需在config/app.php配置
   Laravel 10中使用Intervention Image 3.x不需要在config/app.php中添加服务提供者或别名，直接通过use语句引用即可。

额外验证 #

如果修改后仍有问题，执行以下命令重新生成自动加载文件：

composer dump-autoload

内容的提问来源于stack exchange，提问作者mstdmstd