如何获取Laravel中广告及其多图的一次性查询与结构化处理

在Laravel项目中，广告模块通常会设计广告主表和广告图片附表，一个广告对应多张展示图片，传统的多次查询方式会增加数据库请求次数，降低接口性能，一次性查询配合结构化处理可以解决这个问题。

一、数据库表与模型关系定义

首先我们需要设计两张表，分别是ads广告表和ad_images广告图片表，ad_images表中通过ad_id字段关联ads表的主键。

对应的迁移文件结构如下：

// ads表迁移
Schema::create('ads', function (Blueprint $table) {
    $table->id();
    $table->string('title');
    $table->text('content');
    $table->timestamps();
});

// ad_images表迁移
Schema::create('ad_images', function (Blueprint $table) {
    $table->id();
    $table->unsignedBigInteger('ad_id');
    $table->string('image_url');
    $table->integer('sort')->default(0);
    $table->timestamps();
    $table->foreign('ad_id')->references('id')->on('ads')->onDelete('cascade');
});

然后在广告模型Ad中定义一对多关系：

<?php

namespace AppModels;

use IlluminateDatabaseEloquentModel;

class Ad extends Model
{
    // 定义与广告图片的一对多关系
    public function images()
    {
        return $this->hasMany(AdImage::class, 'ad_id', 'id')->orderBy('sort', 'asc');
    }
}

广告图片模型AdImage的代码如下：

<?php

namespace AppModels;

use IlluminateDatabaseEloquentModel;

class AdImage extends Model
{
    protected $fillable = ['ad_id', 'image_url', 'sort'];
}

二、一次性查询广告及其多图

使用Eloquent的with方法可以实现渴求式加载，一次性查询出所有需要的广告和对应的图片数据，避免N+1查询问题。

查询指定条件广告及其多图的代码示例：

<?php

namespace AppHttpControllers;

use AppModelsAd;
use IlluminateHttpRequest;

class AdController extends Controller
{
    // 获取广告列表及对应多图
    public function index(Request $request)
    {
        // 一次性查询广告和关联图片，支持筛选条件
        $ads = Ad::with('images')
            ->when($request->has('title'), function ($query) use ($request) {
                $query->where('title', 'like', '%' . $request->input('title') . '%');
            })
            ->orderBy('created_at', 'desc')
            ->paginate(10);
        
        return response()->json($ads);
    }
}

三、查询结果结构化处理

默认返回的模型实例可能包含很多不需要的字段，比如时间戳、外键等，我们可以通过在模型中定义toArray方法或者资源类来结构化处理返回数据。

方式1：模型重写toArray方法

在Ad模型中重写toArray方法，定义返回的结构：

<?php

namespace AppModels;

use IlluminateDatabaseEloquentModel;

class Ad extends Model
{
    public function images()
    {
        return $this->hasMany(AdImage::class, 'ad_id', 'id')->orderBy('sort', 'asc');
    }

    // 重写toArray方法结构化输出
    public function toArray()
    {
        return [
            'id' => $this->id,
            'title' => $this->title,
            'content' => $this->content,
            'images' => $this->images->map(function ($image) {
                return [
                    'id' => $image->id,
                    'url' => $image->image_url,
                    'sort' => $image->sort
                ];
            })->toArray(),
            'created_at' => $this->created_at->format('Y-m-d H:i:s')
        ];
    }
}

方式2：使用API资源类处理

Laravel提供的API资源类可以更灵活地控制返回结构，首先创建广告资源类：

// 执行命令生成资源类：php artisan make:resource AdResource
<?php

namespace AppHttpResources;

use IlluminateHttpRequest;
use IlluminateHttpResourcesJsonJsonResource;

class AdResource extends JsonResource
{
    public function toArray(Request $request)
    {
        return [
            'id' => $this->id,
            'title' => $this->title,
            'content' => $this->content,
            'images' => AdImageResource::collection($this->whenLoaded('images')),
            'created_at' => $this->created_at->format('Y-m-d H:i:s')
        ];
    }
}

对应的广告图片资源类：

// 执行命令生成资源类：php artisan make:resource AdImageResource
<?php

namespace AppHttpResources;

use IlluminateHttpRequest;
use IlluminateHttpResourcesJsonJsonResource;

class AdImageResource extends JsonResource
{
    public function toArray(Request $request)
    {
        return [
            'id' => $this->id,
            'url' => $this->image_url,
            'sort' => $this->sort
        ];
    }
}

修改控制器使用资源类返回数据：

<?php

namespace AppHttpControllers;

use AppHttpResourcesAdResource;
use AppModelsAd;
use IlluminateHttpRequest;

class AdController extends Controller
{
    public function index(Request $request)
    {
        $ads = Ad::with('images')
            ->when($request->has('title'), function ($query) use ($request) {
                $query->where('title', 'like', '%' . $request->input('title') . '%');
            })
            ->orderBy('created_at', 'desc')
            ->paginate(10);
        
        return AdResource::collection($ads);
    }
}

四、注意事项

• 使用with方法时要确保关系方法名和传入的参数一致，否则会导致加载失败
• 如果不需要所有图片字段，可以在with中使用闭包指定查询字段，比如with(['images:id,ad_id,image_url,sort'])减少数据传输
• 结构化处理时如果需要兼容分页数据，资源类的collection方法会自动处理分页结构，不需要额外调整

通过一次性查询加结构化处理的方式，既可以提升接口响应速度，又能让返回的数据格式更符合前端使用习惯，减少前端二次处理的工作量。

Laravel广告多图查询一次性查询结构化处理eloquent_关系修改时间：2026-06-13 00:33:43