在 Laravel 中同时存储原始图片和 WebP 转换图片

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use App\Models\Image; // 假设你有一个 Image 模型用于存储图片信息

class ImageController extends Controller
{
    /**
     * 处理图片上传、保存原始图片并转换为 WebP。
     *
     * @param Request $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function store(Request $request)
    {
        // 1. 文件验证
        if (!$request->hasFile('fileName') || !$request->file('fileName')->isValid()) {
            return response()->json(['error' => '未找到上传文件或文件无效'], 400);
        }

        $file = $request->file('fileName');
        $allowedExtensions = ['jpg', 'jpeg', 'png'];
        $extension = strtolower($file->getClientOriginalExtension());

        if (!in_array($extension, $allowedExtensions)) {
            return response()->json(['error' => '不支持的文件格式，只允许 JPG, JPEG, PNG'], 422);
        }

        // 2. 定义存储路径和文件名
        // 建议使用 Storage 门面来管理文件存储，无论本地还是云存储
        $disk = 'public'; // 使用 public 磁盘，实际路径为 storage/app/public
        $folder = 'images/article-images';
        $originalFileName = pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME);
        $uniqueId = uniqid(); // 生成唯一ID，避免文件名冲突
        $originalImageName = $originalFileName . '_' . $uniqueId . '.' . $extension;
        $webpImageName = $originalFileName . '_' . $uniqueId . '.webp';

        // 3. 保存原始图片到 Laravel 存储
        // putFileAs 会自动生成一个唯一的哈希文件名，但我们这里想保留原始文件名的一部分
        // 或者直接使用 putFileAs，然后记录其返回的路径
        $originalPath = Storage::disk($disk)->putFileAs($folder, $file, $originalImageName);

        if (!$originalPath) {
            return response()->json(['error' => '无法保存原始图片'], 500);
        }

        // 4. 获取原始图片的完整文件系统路径，用于 GD 库处理
        // 注意：Storage::path() 返回的是文件在服务器上的绝对路径
        $fullOriginalImagePath = Storage::disk($disk)->path($originalPath);

        // 5. 使用 GD 库创建图像资源
        $image = null;
        switch ($extension) {
            case 'jpeg':
            case 'jpg':
                $image = imagecreatefromjpeg($fullOriginalImagePath);
                break;
            case 'png':
                $image = imagecreatefrompng($fullOriginalImagePath);
                // 对于 PNG，需要保留透明度
                imagealphablending($image, false);
                imagesavealpha($image, true);
                break;
            default:
                // 理论上前面已经过滤了，这里作为保险
                return response()->json(['error' => '不支持的图像格式进行 GD 处理'], 500);
        }

        if (!$image) {
            return response()->json(['error' => '无法创建图像资源'], 500);
        }

        // 6. 转换为真彩色（如果不是）
        // 某些调色板图像（如GIF）转换为WebP可能需要先转为真彩色
        imagepalettetotruecolor($image);

        // 7. 将图像资源保存为 WebP 格式到临时位置
        $tempWebpPath = tempnam(sys_get_temp_dir(), 'webp_'); // 创建临时文件
        if (!imagewebp($image, $tempWebpPath, 80)) { // 80 是 WebP 质量 (0-100)
            imagedestroy($image);
            @unlink($tempWebpPath); // 清理临时文件
            return response()->json(['error' => '无法将图片转换为 WebP 格式'], 500);
        }

        // 8. 将 WebP 临时文件移动到 Laravel 存储
        $webpStoragePath = $folder . '/' . $webpImageName;
        $webpContent = file_get_contents($tempWebpPath);
        if (!Storage::disk($disk)->put($webpStoragePath, $webpContent)) {
            imagedestroy($image);
            @unlink($tempWebpPath);
            return response()->json(['error' => '无法保存 WebP 图片到存储'], 500);
        }

        // 清理 GD 资源和临时文件
        imagedestroy($image);
        @unlink($tempWebpPath);

        // 9. 更新数据库（示例）
        $imageModel = new Image();
        $imageModel->title = $originalFileName;
        $imageModel->original_path = $originalPath; // 存储原始图片路径
        $imageModel->webp_path = $webpStoragePath;   // 存储 WebP 图片路径
        $imageModel->description = $request->description;
        $imageModel->author_id = $request->author_id;
        $imageModel->save();

        // 10. 关联文章（如果需要）
        if ($request->article_id) {
            // 假设 Image 模型与 Article 模型有多对多关系
            $imageModel->articles()->attach($request->article_id);
        }

        return response()->json(['message' => '图片上传成功', 'image' => $imageModel], 201);
    }
}