Laravel批量压缩图片遇Intervention Image类找不到问题求助

问题背景 #

在Laravel项目中实现多图片压缩功能，已通过composer require intervention/image "^2.5"安装扩展，手动添加了服务提供者Intervention\Image\ImageServiceProvider::class和别名'Image' => Intervention\Image\Facades\Image::class，但引入压缩代码后仍报错：Intervention\Image\Facades\Image not found in file。

原始未压缩上传代码 #

namespace App\Http\Controllers;

use App\Http\Resources\PhotoResource;
use App\Models\Apartment;
use Illuminate\Validation\Rule;
use App\Models\Photo;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
//use Intervention\Image\Facades\Image;
// use Intervention\Image\ImageManagerStatic as Image;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\Validator;

public function addImages(Request $request)
{
    $fields = [
        'apartment_id' => 'required|exists:apartments,id',
        'images.*' => 'required|image|mimes:jpeg,png,jpg,gif|max:2048',
    ];

    $validator = Validator::make($request->all(), $fields);

    if ($validator->fails()) {
        $msg = $validator->messages()->first();
        return $this->fail($msg);
    }

    $uploadedImages = [];

    $images = $request->file('images');

    if (!is_array($images)) {
        return $this->fail('Images must be an array.');
    }
    $apartmentId = $request->input('apartment_id');

    foreach ($images as $image) {
        $imageName = 'img_' . rand(1, 150000) . '.png';
        $dir = "images/apartments_images";
        $image->move(public_path($dir), $imageName);
        $path = $dir . '/' . $imageName;
        // $quitUrl = 'http://127.0.0.1:8000/' . $path;
        $quitUrl = url($path);

        $data = Photo::create([
            'url' => $quitUrl,
            'apartment_id' => $apartmentId,
        ]);

        $uploadedImages[] = new PhotoResource($data);
    }

    return $this->success($uploadedImages);
}

修改后尝试压缩的代码 #

namespace App\Http\Controllers;

use App\Http\Resources\PhotoResource;
use App\Models\Apartment;
use Illuminate\Validation\Rule;
use App\Models\Photo;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Intervention\Image\Facades\Image;
// use Intervention\Image\ImageManagerStatic as Image;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\Validator;

public function addImages(Request $request)
{
    $fields = [
        'apartment_id' => 'required|exists:apartments,id',
        'images.*' => 'required|image|mimes:jpeg,png,jpg,gif|max:2048',
    ];

    $validator = Validator::make($request->all(), $fields);

    if ($validator->fails()) {
        $msg = $validator->messages()->first();
        return $this->fail($msg);
    }

    $uploadedImages = [];

    $images = $request->file('images');

    if (!is_array($images)) {
        return $this->fail('Images must be an array.');
    }
    $apartmentId = $request->input('apartment_id');

    foreach ($images as $image) {
        $imageName = 'img_' . rand(1, 150000) . '.png';
        $dir = "images/apartments_images";
        $image->move(public_path($dir), $imageName);
        $path = $dir . '/' . $imageName;
        $img = Image::make($image->getRealPath());

        // Compress the image
        $img->resize(800, null, function ($constraint) {
            $constraint->aspectRatio();
        })->save(public_path($dir . '/' . $imageName), 75);
        // $quitUrl = 'http://127.0.0.1:8000/' . $path;
        $quitUrl = url($path);

        $data = Photo::create([
            'url' => $quitUrl,
            'apartment_id' => $apartmentId,
        ]);

        $uploadedImages[] = new PhotoResource($data);
    }

    return $this->success($uploadedImages);
}

解决步骤 #

1. 版本兼容性检查 #

Intervention Image 2.x适配Laravel 5.x-8.x，若使用Laravel 9+，需安装3.x版本：

composer require intervention/image "^3.0"

3.x版本命名空间变更，使用方式调整为：

use Intervention\Image\ImageManager;

$manager = new ImageManager(['driver' => 'gd']);
$img = $manager->make($image->getRealPath());

2. 清除缓存并重新发布配置 #

手动添加的服务提供者/别名可能因缓存未生效，执行以下命令：

# 发布Intervention配置文件（2.x版本）
php artisan vendor:publish --provider="Intervention\Image\ImageServiceProviderLaravel5"
# 清除配置缓存
php artisan config:clear
# 清除类加载缓存
php artisan optimize:clear

3. 修正代码逻辑错误 #

原代码先执行$image->move()，临时文件已被移动，$image->getRealPath()指向不存在的文件，导致压缩失败。调整为先压缩再保存：

foreach ($images as $image) {
    $imageName = 'img_' . rand(1, 150000) . '.png';
    $dir = "images/apartments_images";
    $targetPath = public_path($dir . '/' . $imageName);

    // 直接从临时文件读取并压缩保存
    $img = Image::make($image->getRealPath());
    $img->resize(800, null, function ($constraint) {
        $constraint->aspectRatio();
    })->save($targetPath, 75);

    $path = $dir . '/' . $imageName;
    $quitUrl = url($path);

    $data = Photo::create([
        'url' => $quitUrl,
        'apartment_id' => $apartmentId,
    ]);

    $uploadedImages[] = new PhotoResource($data);
}

4. 确认命名空间引入 #

2.x版本确保正确引入：

use Intervention\Image\Facades\Image;

或直接使用全名避免别名冲突：

$img = \Intervention\Image\Facades\Image::make($image->getRealPath());

5. 检查依赖扩展 #

Intervention Image需要GD或Imagick扩展，执行以下命令确认：

# 检查GD扩展
php -m | grep gd
# 检查Imagick扩展
php -m | grep imagick

缺少对应扩展时，安装后重启服务器。

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