Laravel8使用spatie/media-library转换PNG丢失透明度如何解决

原因 #

spatie/laravel-medialibrary 使用GD作为默认图像驱动时，裁剪缩放PNG等带透明通道的图片时，默认不会保留透明通道，会将透明区域填充为纯色。你已经配置了keepOriginalImageFormat()，仅需补充透明度保留配置即可解决问题。

解决方法 #

方案1：调整媒体转换配置

直接在现有转换逻辑中补充透明度相关配置即可，修改后代码如下：

public function registerMediaCollections(): void
{
    $this->addMediaCollection('crops')
        ->singleFile()
        ->useDisk('public')
        ->acceptsMimeTypes([
            'image/jpeg', 'image/png', 'image/jpg',
        ])
        ->onlyKeepLatest(1)
        ->registerMediaConversions(function (Media $media) {
            $this
                ->addMediaConversion('thumb')
                ->fit(Manipulations::FIT_CROP, 150, 150)
                ->keepOriginalImageFormat()
                // 保留PNG透明度配置
                ->withSaveOptions([
                    'alpha' => true,
                    'png_compression_level' => 9
                ]);
        });
}

如果上述配置在你的版本中不生效，可以改用tap方法直接操作底层干预图像实例：

->registerMediaConversions(function (Media $media) {
    $this
        ->addMediaConversion('thumb')
        ->fit(Manipulations::FIT_CROP, 150, 150)
        ->keepOriginalImageFormat()
        ->tap(function (\Intervention\Image\Image $image) {
            if ($image->mime === 'image/png') {
                // 编码PNG时自动保留透明通道
                $image->encode('png', 9);
            }
        });
});

方案2：更换图像驱动为Imagick

如果服务器已安装Imagick扩展，修改Laravel图像配置即可从根源解决透明度丢失问题：

1. 若没有图像配置文件，先执行发布命令：
   php artisan vendor:publish --provider="Intervention\Image\ImageServiceProviderLaravelRecent"
2. 打开config/image.php，将驱动配置修改为imagick：

return [
    'driver' => 'imagick',
];

Imagick对透明通道的处理更完善，无需额外配置转换规则即可自动保留PNG、WebP等格式的透明属性。

验证 #

修改完成后清空项目缓存，重新上传带透明度的图片生成缩略图即可验证效果。

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