最稳定方式是用 Spatie MediaLibrary 配合自定义转换生成高清图：先安装包并迁移数据库，再在 Product 模型中启用媒体支持并注册 hd-main（contain+白底+webp）和 white-bg（crop+白底+webp）转换，最后上传原图自动按需生成缓存变体。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在 Laravel 项目中批量生成适配电商场景的高清产品图片，包括主图、白底图、详情页套图等，且要求尺寸精准、背景干净、支持自动裁剪与格式优化。
用 Spatie MediaLibrary 配合自定义转换生成高清图
这是生产环境最稳定的方式，所有图像变体均按需生成并缓存，避免运行时重复处理。
第一步：安装包并迁移数据库
执行 composer require spatie/laravel-medialibrary → 运行 php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="migrations" → 执行 php artisan migrate。
第二步：在 Product 模型中启用媒体支持并注册高清转换
在 app/Models/Product.php 中添加 use Spatie\MediaLibrary\HasMedia; use Spatie\MediaLibrary\InteractsWithMedia;，并在类声明后加入 use InteractsWithMedia;；然后在类内添加方法：
public function registerMediaConversions(Media $media = null): void {<br> $this->addMediaConversion('hd-main')<br> ->width(1200)<br> ->height(1200)<br> ->fit('contain', 1200, 1200)<br> ->background('#ffffff')<br> ->format('webp')<br> ->quality(92);<br> $this->addMediaConversion('white-bg')<br> ->width(800)<br> ->height(800)<br> ->fit('crop', 800, 800)<br> ->background('#ffffff')<br> ->format('webp')<br> ->quality(95);<br>}
注意：fit('contain') 会保持原始比例并居中填充至 1200×1200 区域，空白处补白；而 fit('crop') 则强制裁切为精确尺寸——【电商主图必须用 contain，否则商品变形会被平台拒审】。
第三步：上传原图并触发转换
在控制器中调用 $product->addMedia($request->file('image'))->toMediaCollection('products');，上传后系统自动按注册规则生成 hd-main.webp 和 white-bg.webp 两版高清图。
用 Intervention Image 手动控制高清参数
适合需要精细干预压缩率、DPI 或添加水印的场景，比如品牌主图需嵌入 logo 文字。
方法一：直接处理并保存高清文件
确保已安装 intervention/image 并配置好门面；在控制器中写：
if ($request->hasFile('image')) {<br> $img = Image::make($request->file('image'));<br> $img->resize(1600, null, function ($constraint) { $constraint->aspectRatio(); });<br> $img->sharpen(10);<br> $img->encode('webp', 95);<br> $path = public_path('images/hd/') . time() . '_main.webp';<br> $img->save($path);<br>}
这一步不依赖数据库关联，适合快速导出单张高清图用于审核或外包交付。
方法二：生成带品牌水印的高清主图
在 resize 后插入：$img->text('®', 50, 50, function ($font) { $font->file(public_path('fonts/arial.ttf')); $font->size(48); $font->color('#000000'); $font->align('center'); $font->valign('middle'); }); → 然后 encode + save。
⚠️ 提示：字体文件必须真实存在，否则 text() 调用会静默失败，图片无水印但不报错。
用腾讯云万象优图远程生成专业级电商图
适用于对画质、色彩还原、智能抠图有极高要求的 SKU，比如珠宝、化妆品等高价值类目。
安装 yuecode/image 扩展包 → 发布配置 → 在控制器中初始化 YouTu 实例：
$youTu = new YouTu(config('image.tencent'));<br>$res = $youTu->uploadImage($request->file('image'));<br>if ($res['code'] == 0) {<br> $url = $res['data']['url'];<br> $hdUrl = str_replace('.jpg', '_hd.jpg', $url); // 万象优图返回 URL 后可拼接 _hd 后缀获取高清版<br> // 再调用 pornDetectUrl 或 imageProcess 接口做智能去背/调色<br>}
这一步操作完成后立即结束。
