如何使用Laravel Media Library仅为多图上传的首张图片添加转换

有两种简单的方式实现仅为房产的第一张上传图片生成转换：

方法一：在控制器中判断并控制转换生成 #

修改上传循环逻辑，通过索引识别第一张图片，仅为其启用转换和响应式图片生成，其他图片跳过所有自动转换：

foreach ($request->file('images') as $index => $image) {
    $mediaUpload = $property->addMedia($image);
    
    // 仅第一张图片生成响应式图片和自定义转换
    if ($index === 0) {
        $mediaUpload->withResponsiveImages();
    } else {
        // 禁用所有自动转换生成
        $mediaUpload->withoutConversions();
    }
    
    $mediaUpload->toMediaCollection();
}

方法二：在模型中限制转换仅在第一张媒体执行 #

利用Laravel Media Library内置的performOnFirstMediaInCollection()方法，让自定义转换仅作用于集合中的第一张图片。如果需要响应式图片也只在第一张生成，可同时在模型中配置响应式转换：

修改模型转换逻辑： #

public function registerMediaConversions(Media $media = null): void
{
    // 自定义缩略图仅在第一张图片生成
    $this->addMediaConversion('small_thumb')
        ->width(300)
        ->height(200)
        ->performOnFirstMediaInCollection();
        
    // 可选：配置响应式图片仅在第一张生成（此时控制器可移除withResponsiveImages()）
    $this->addMediaConversion('responsive_webp')
        ->format('webp')
        ->withResponsiveImages()
        ->performOnFirstMediaInCollection();
}

控制器可简化为： #

foreach ($request->file('images') as $image) {
    $property->addMedia($image)->toMediaCollection();
}

注：如果选择方法二，且仍保留控制器中的withResponsiveImages()，需要确保仅对第一张图片调用该方法，否则所有图片仍会生成默认响应式转换。

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