如何在Laravel Spatie MediaLibrary中新增转换而无需重新上传？

1. 在模型中添加新的转换规则 #

找到对应业务模型（比如Product模型），在registerMediaConversions方法里，为product-image集合新增152*152的转换规则：

public function registerMediaConversions(Media $media = null): void
{
    // 保留已有的thumb、block转换配置
    $this->addMediaConversion('thumb')
         ->width(70)
         ->height(70)
         ->nonQueued();

    $this->addMediaConversion('block')
         ->width(100)
         ->height(100)
         ->nonQueued();

    // 新增152*152的转换，命名可自定义，比如'grid-152'
    $this->addMediaConversion('grid-152')
         ->width(152)
         ->height(152)
         ->nonQueued(); // 若需异步处理，可移除nonQueued()并结合队列使用
}

2. 用Artisan命令重新生成新转换 #

Spatie MediaLibrary提供了原生命令，直接从已上传的原始文件生成新转换，无需重新上传：

• 仅针对product-image集合的grid-152转换生成（推荐，效率更高）：

php artisan media-library:regenerate --collection="product-image" --conversion="grid-152"

• 如果需要为所有媒体集合生成该转换，去掉--collection参数即可：

php artisan media-library:regenerate --conversion="grid-152"

3. 批量处理优化（可选） #

如果媒体文件数量较多，建议将生成任务放入队列避免超时：

php artisan media-library:regenerate --collection="product-image" --conversion="grid-152" --queue

随后启动队列工作者执行任务：

php artisan queue:work

原理说明 #

该命令会读取每个媒体的原始上传文件，应用新的转换规则生成图片，自动保存到现有/storage/../conversions/路径下，不会改动已有的转换文件，全程无需重新上传原文件。

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