Laravel资源集合如何返回嵌套数组首元素？列表页仅取首图

可以通过以下几种方式实现需求，根据你的代码结构选择合适的方案：

方案一：利用Resource根据请求场景返回不同数据 #

修改AdvertResource的toArray方法，判断当前请求是列表页（index）还是详情页（show），动态返回图片数据：

public function toArray($request)
{
    // 判断当前控制器方法是否为index
    $isIndex = $request->route()->getActionMethod() === 'index';
    
    return [
        'title' => $this->title,
        'price' => $this->price,
        'image' => $isIndex 
            ? ($this->image->isNotEmpty() ? new AdvertImgResource($this->image->first()) : null)
            : AdvertImgResource::collection($this->image),
        'created_at' => $this->created_at
    ];
}

也可以通过路由名称判断（假设index路由名为adverts.index，show为adverts.show）：

$isIndex = $request->route()->getName() === 'adverts.index';

方案二：新增模型关联获取首张图片 #

在Advert模型中新增一个firstImage关联，专门返回首张图片：

public function firstImage()
{
    // 按创建时间取最早的一张，可根据需求调整排序规则
    return $this->hasOne(AdvertImage::class)->oldest();
}

修改控制器的index方法，预加载这个关联：

public function index()
{
    return AdvertResource::collection(Advert::with('firstImage')->paginate(10));
}

同时调整AdvertResource的逻辑：

public function toArray($request)
{
    $data = [
        'title' => $this->title,
        'price' => $this->price,
        'created_at' => $this->created_at
    ];
    
    // 列表页返回单张图片，详情页返回完整图片列表
    if (isset($this->firstImage)) {
        $data['image'] = $this->firstImage ? new AdvertImgResource($this->firstImage) : null;
    } else {
        $data['image'] = AdvertImgResource::collection($this->image);
    }
    
    return $data;
}

注意：show方法仍保持原有的with('image')预加载逻辑即可。

方案三：控制器中直接处理查询结果 #

在index方法里，查询广告后手动处理每个广告的图片数据：

public function index()
{
    $adverts = Advert::with('image')->paginate(10);
    
    // 遍历广告，只保留第一张图片
    $adverts->getCollection()->transform(function ($advert) {
        if ($advert->image->isNotEmpty()) {
            $advert->image = $advert->image->first();
        }
        return $advert;
    });
    
    return AdvertResource::collection($adverts);
}

这种方式不需要修改Resource，但需要注意：如果保持原Resource逻辑，返回的image会是单个对象而非数组，符合列表页展示首张图的需求。

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