Laravel中基于查询字符串的图片动态缩放路由实现问询

我来帮你搞定这个Laravel下的动态图片缩放需求，刚好之前处理过类似场景，给你一套完整的实现方案，能覆盖你提到的所有情况——不管图片在什么路由路径下，只要带width/height查询参数，都能自动生成缩略图，还能解决LFM这类路由和真实目录不一致的问题，完全不需要在模板里调用自定义类。

1. 配置全局路由 #

首先要在routes/web.php里添加一个全局路由，捕获所有带图片后缀且带有查询参数的请求：

use App\Http\Controllers\ImageResizeController;

Route::get('{path}.{extension}', [ImageResizeController::class, 'handle'])
    ->where('path', '.*') // 匹配任意层级的路径，比如/anything/1或者laravel-filemanager/share/image
    ->whereIn('extension', ['jpg', 'jpeg', 'png', 'webp']); // 限制支持的图片格式

这个路由会匹配所有类似example.com/1.jpg?width=120、example.com/anything/1.jpg?width=120、example.com/laravel-filemanager/share/image.jpg?height=80的请求，完美覆盖你需要的场景。

2. 创建图片处理控制器 #

生成一个专门处理图片缩放的控制器：

php artisan make:controller ImageResizeController

然后在控制器里实现核心逻辑，分为路径解析、参数验证、缓存处理、图片缩放四个部分：

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Intervention\Image\Facades\Image;
use Illuminate\Support\Facades\File;

class ImageResizeController extends Controller
{
    public function handle(string $path, string $extension)
    {
        // 1. 获取并验证缩放参数
        $width = request()->query('width');
        $height = request()->query('height');
        $maxAllowedSize = 2000; // 限制最大尺寸，防止恶意请求生成超大图片

        // 处理参数，超出最大值则强制限制
        if ($width && $width > $maxAllowedSize) $width = $maxAllowedSize;
        if ($height && $height > $maxAllowedSize) $height = $maxAllowedSize;

        // 如果没有传任何缩放参数，直接返回原图
        if (!$width && !$height) {
            $realPath = $this->getRealFilePath($path, $extension);
            return file_exists($realPath) ? response()->file($realPath) : abort(404);
        }

        // 2. 获取图片真实路径（解决LFM等路由与真实目录不一致的问题）
        $realPath = $this->getRealFilePath($path, $extension);
        if (!file_exists($realPath)) {
            abort(404, '原图不存在');
        }

        // 3. 生成缓存文件路径（避免重复处理，提升性能）
        $cacheKey = md5($realPath . $width . $height);
        $cacheDir = storage_path('app/public/resized');
        $cachePath = $cacheDir . '/' . $cacheKey . '.' . $extension;

        // 如果缓存已存在，直接返回缓存图片
        if (file_exists($cachePath)) {
            return $this->returnImageResponse($cachePath);
        }

        // 4. 使用Intervention Image处理图片缩放
        File::ensureDirectoryExists($cacheDir, 0755, true); // 确保缓存目录存在

        $image = Image::make($realPath);
        if ($width && !$height) {
            // 只传width，按比例缩放高度
            $image->resize($width, null, function ($constraint) {
                $constraint->aspectRatio();
                $constraint->upsize(); // 防止放大原图
            });
        } elseif ($height && !$width) {
            // 只传height，按比例缩放宽度
            $image->resize(null, $height, function ($constraint) {
                $constraint->aspectRatio();
                $constraint->upsize();
            });
        } else {
            // 同时传width和height，裁剪成指定尺寸（保持比例）
            $image->fit($width, $height, function ($constraint) {
                $constraint->upsize();
            });
        }

        $image->save($cachePath);

        // 返回处理后的图片
        return $this->returnImageResponse($cachePath);
    }

    /**
     * 处理路由路径到真实文件路径的映射
     * 可根据你的实际场景扩展更多规则
     */
    private function getRealFilePath(string $path, string $extension): string
    {
        // 处理LFM的路由：laravel-filemanager/share/image → public/share/image
        if (str_starts_with($path, 'laravel-filemanager/')) {
            $path = str_replace('laravel-filemanager/', '', $path);
        }

        // 其他特殊路由映射可以在这里添加，比如自定义的媒体路由等

        // 最终返回public目录下的真实路径
        return public_path($path . '.' . $extension);
    }

    /**
     * 返回带缓存头的图片响应，提升浏览器缓存性能
     */
    private function returnImageResponse(string $filePath)
    {
        return response()->file($filePath)->withHeaders([
            'Cache-Control' => 'public, max-age=31536000', // 缓存1年
            'Expires' => gmdate('D, d M Y H:i:s \G\M\T', time() + 31536000),
        ]);
    }
}

3. 额外配置与优化 #

• 确保Intervention Image已安装：如果还没装，执行以下命令并配置：

  composer require intervention/image
  

  然后在config/app.php的providers数组里添加：

  Intervention\Image\ImageServiceProvider::class,
  

  在aliases数组里添加：

  'Image' => Intervention\Image\Facades\Image::class,
  

• 缓存清理：可以创建一个Artisan命令定期清理过期的缓存图片，或者在原图更新时，根据原图路径删除对应的缓存文件。

• 安全防护：除了限制最大尺寸，还可以添加IP限流、请求频率限制，防止恶意请求消耗服务器资源。

现在你只需要保持原来的img标签写法（比如<img src="/anything/1.jpg?width=120">或者<img src="/laravel-filemanager/share/image.jpg?height=80">），所有带缩放参数的图片请求都会被自动处理，完全不需要在模板里调用自定义类。

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