Laravel中如何用Spatie Media Library按1:1/4:3比例生成图片转换图？

代码问题分析与修正 #

你当前的代码用固定宽高设置转换，无法实现按比例裁剪的需求，且可能因配置逻辑导致转换未触发。以下是修正后的代码，精准实现1:1和4:3比例的裁剪效果：

use Spatie\Image\Manipulations;

public function registerMediaCollections(): void
{
    $this->addMediaCollection('featured-image')
        ->singleFile()
        ->registerMediaConversions(function (Media $media) {
            // 1:1 比例裁剪（以原图宽度为基准，居中裁剪出正方形）
            $this->addMediaConversion('square')
                ->fit(Manipulations::FIT_CROP, 1600, 1600, Manipulations::POSITION_CENTER)
                ->nonQueued();

            // 4:3 比例裁剪（宽度匹配原图，高度按4:3比例计算）
            $this->addMediaConversion('card')
                ->fit(Manipulations::FIT_CROP, 1600, 1200, Manipulations::POSITION_CENTER)
                ->nonQueued();
        });
}

如果需要自适应原图尺寸（而非固定1600宽度），可以改用以下配置，自动按比例裁剪且限制最大尺寸：

// 1:1 自适应裁剪，最大边长不超过1600
$this->addMediaConversion('square')
    ->fit(Manipulations::FIT_CROP)
    ->maxWidth(1600)
    ->maxHeight(1600)
    ->nonQueued();

// 4:3 自适应裁剪，最大宽度1600，高度按比例匹配
$this->addMediaConversion('card')
    ->fit(Manipulations::FIT_CROP)
    ->maxWidth(1600)
    ->aspectRatio(4/3)
    ->nonQueued();

转换不生效的排查步骤 #

1. 检查依赖环境：确认服务器已安装GD或Imagick扩展，Spatie依赖这两个扩展处理图片转换。
2. 重新生成转换：之前上传的图片不会自动应用新配置的转换，需手动触发：

   // 为单个产品重新生成转换
   $product = Product::find($id);
   $product->getFirstMedia('featured-image')->regenerateConversions();
   

3. 验证上传逻辑：确保上传时正确关联到featured-image集合：

   $product->addMedia($request->file('image'))->toMediaCollection('featured-image');
   

4. 检查配置文件：确认config/media-library.php中的image_driver设置为gd或imagick，且存储目录具备写入权限。

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