Laravel如何通过模型关联获取图片信息并优化查询

问题背景 #

现有模型结构如下：

• Product 模型
  • id（字段）
  • productname（字段）
• ProductGallery 模型（中间关联表）
  • galleryid（字段）
  • productid（字段）
• Galleries 模型
  • id（字段）
  • imagename（字段）

需要获取如下格式的数据：

"id" => 1
productname => "product 1"
galleries => {
   0 => {
         id => 1,
         imagename => 'image 1'
        }
   1 => {
         id => 2,
         imagename => 'image 2'
        }
}

请问如何通过Laravel的模型关联实现该需求，并进行查询优化？

一、定义模型关联 #

这是典型的多对多关联场景，Product 和 Galleries 通过 ProductGallery 中间表建立关联，在对应模型中定义关联关系：

1. Product 模型

在 app/Models/Product.php 中添加关联方法：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;

class Product extends Model
{
    protected $table = 'products'; // 替换为你的实际表名
    protected $primaryKey = 'id';

    // 关联Galleries模型
    public function galleries(): BelongsToMany
    {
        return $this->belongsToMany(
            Galleries::class,
            'product_gallery', // 中间表名，替换为实际表名
            'productid', // 当前模型在中间表的外键
            'galleryid' // 关联模型在中间表的外键
        )->select(['galleries.id', 'galleries.imagename']); // 仅查询需要的字段，减少数据传输
    }
}

2. Galleries 模型（可选，用于反向关联）

在 app/Models/Galleries.php 中添加：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;

class Galleries extends Model
{
    protected $table = 'galleries';
    protected $primaryKey = 'id';

    public function products(): BelongsToMany
    {
        return $this->belongsToMany(
            Product::class,
            'product_gallery',
            'galleryid',
            'productid'
        );
    }
}

二、查询实现与优化 #

核心优化点是避免N+1查询问题，使用Laravel的预加载（Eager Loading）功能：

1. 查询单个产品及关联图库

// 预加载关联，避免额外查询
$product = Product::with('galleries')->find(1);

// 直接转换为符合需求的数组格式
$formattedData = $product->toArray();

2. 进一步优化：指定查询字段

如果只需产品的部分字段，可明确指定，减少数据库查询的数据量：

$product = Product::select('id', 'productname')
    ->with(['galleries' => function ($query) {
        $query->select('id', 'imagename');
    }])
    ->find(1);

3. 批量查询多个产品

批量查询时同样使用预加载，确保性能：

$products = Product::select('id', 'productname')
    ->with('galleries')
    ->get();

// 遍历处理每个产品
foreach ($products as $product) {
    $formattedData = $product->toArray();
    // 后续逻辑...
}

三、关键注意事项 #

• 确保中间表的表名、外键字段名与模型中定义的一致，若不符合Laravel默认命名规范，必须在关联方法中明确指定。
• 始终使用select()筛选需要的字段，避免查询冗余数据。
• 禁止在循环中单独查询每个产品的图库，否则会触发N+1查询，严重影响性能。

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