Laravel图片处理：使用原生PHP实现原始图片与WebP格式共存存储

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str; // For unique file names

class ImageController extends Controller
{
    public function storeImage(Request $request)
    {
        // 验证文件上传
        $request->validate([
            'fileName' => 'required|image|mimes:jpeg,jpg,png|max:2048', // 允许的图片类型和大小
        ]);

        $uploadedFile = $request->file('fileName');
        $originalExtension = $uploadedFile->getClientOriginalExtension();
        $originalFileName = Str::random(40) . '.' . $originalExtension; // 生成唯一文件名
        $relativePath = 'images/uploads/' . date('Y/m'); // 存储原始图片的相对路径
        $fullPath = public_path($relativePath); // 完整的公共路径

        // 确保目标目录存在
        if (!file_exists($fullPath)) {
            mkdir($fullPath, 0755, true);
        }

        // 保存原始图片
        if (!$uploadedFile->move($fullPath, $originalFileName)) {
            return response()->json(['message' => 'Failed to save original image.'], 500);
        }

        $originalImagePath = $relativePath . '/' . $originalFileName; // 存储到数据库的路径

        // ... 后续可以保存 $originalImagePath 到数据库
        // $imageModel = new Image();
        // $imageModel->path = $originalImagePath;
        // $imageModel->save();

        // 继续进行WebP转换
        return $this->convertToWebP($fullPath . '/' . $originalFileName, $relativePath, $originalFileName);
    }

    /**
     * 将图片转换为WebP格式并保存
     *
     * @param string $sourceImagePath 原始图片的完整文件路径
     * @param string $targetRelativePath WebP图片存储的相对路径（不含文件名）
     * @param string $originalFileName 原始图片的文件名（用于生成WebP文件名）
     * @param int $quality WebP图片的质量 (0-100)
     * @return \Illuminate\Http\JsonResponse
     */
    private function convertToWebP(string $sourceImagePath, string $targetRelativePath, string $originalFileName, int $quality = 80)
    {
        // 从文件内容创建图像资源
        $imageContent = file_get_contents($sourceImagePath);
        if ($imageContent === false) {
            return response()->json(['message' => 'Failed to read original image for WebP conversion.'], 500);
        }

        $im = imagecreatefromstring($imageContent);

        if ($im === false) {
            return response()->json(['message' => 'Failed to create image resource from string.'], 500);
        }

        // 转换为真彩色图像（对于某些操作和格式转换是必需的）
        imagepalettetotruecolor($im);

        // 生成WebP文件名，替换原始扩展名
        $webpFileName = preg_replace('/\.(jpg|jpeg|png)$/i', '.webp', $originalFileName);
        $webpFullPath = public_path($targetRelativePath . '/' . $webpFileName);

        // 确保WebP目标目录存在
        if (!file_exists(dirname($webpFullPath))) {
            mkdir(dirname($webpFullPath), 0755, true);
        }

        // 保存为WebP格式
        if (!imagewebp($im, $webpFullPath, $quality)) {
            imagedestroy($im); // 释放内存
            return response()->json(['message' => 'Failed to save WebP image.'], 500);
        }

        imagedestroy($im); // 释放内存

        $webpImagePath = $targetRelativePath . '/' . $webpFileName; // 存储到数据库的WebP路径

        return response()->json([
            'message' => 'Images saved successfully.',
            'original_path' => $sourceImagePath,
            'webp_path' => $webpImagePath
        ], 200);
    }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;

class MediaController extends Controller
{
    /**
     * 处理图片上传、保存原始图片并转换为WebP格式。
     *
     * @param Request $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function uploadAndConvertImage(Request $request)
    {
        // 1. 验证文件上传
        $request->validate([
            'image_file' => 'required|image|mimes:jpeg,jpg,png|max:5120', // 最大5MB
        ]);

        $uploadedFile = $request->file('image_file');
        $originalExtension = $uploadedFile->getClientOriginalExtension();
        $baseFileName = Str::random(20); // 生成一个基础文件名，不含扩展名

        // 定义存储路径（相对于 public 目录）
        $storageRelativeDir = 'uploads/' . date('Y/m/d');
        $storageFullPath = public_path($storageRelativeDir);

        // 确保目标目录存在
        if (!file_exists($storageFullPath)) {
            mkdir($storageFullPath, 0755, true);
        }

        // 2. 保存原始图片
        $originalFileName = $baseFileName . '.' . $originalExtension;
        $originalFileSavePath = $storageFullPath . '/' . $originalFileName; // 原始图片完整文件路径
        $originalWebPath = $storageRelativeDir . '/' . $originalFileName; // 用于数据库或前端的Web路径

        if (!$uploadedFile->move($storageFullPath, $originalFileName)) {
            return response()->json(['message' => 'Failed to save original image.'], 500);
        }

        // 3. 转换并保存WebP图片
        $webpFileName = $baseFileName . '.webp';
        $webpFileSavePath = $storageFullPath . '/' . $webpFileName; // WebP图片完整文件路径
        $webpWebPath = $storageRelativeDir . '/' . $webpFileName; // 用于数据库或前端的Web路径
        $webpQuality = 80; // WebP质量 (0-100)

        // 从原始图片创建GD图像资源
        $im = null;
        switch (strtolower($originalExtension)) {
            case 'jpeg':
            case 'jpg':
                $im = imagecreatefromjpeg($originalFileSavePath);
                break;
            case 'png':
                $im = imagecreatefrompng($originalFileSavePath);
                // 对于PNG，需要保留透明度
                imagealphablending($im, false);
                imagesavealpha($im, true);
                break;
            // 可以根据需要添加其他格式
            default:
                return response()->json(['message' => 'Unsupported original image format for WebP conversion.'], 422);
        }

        if ($im === false) {
            return response()->json(['message' => 'Failed to create image resource from original file.'], 500);
        }

        // 转换为真彩色图像
        imagepalettetotruecolor($im);

        // 保存为WebP格式
        if (!imagewebp($im, $webpFileSavePath, $webpQuality)) {
            imagedestroy($im);
            return response()->json(['message' => 'Failed to save WebP image.'], 500);
        }

        imagedestroy($im); // 释放内存

        // 4. 返回成功响应，包含图片路径
        return response()->json([
            'message' => 'Images uploaded and converted successfully.',
            'original_image_url' => asset($originalWebPath),
            'webp_image_url' => asset($webpWebPath),
            'original_db_path' => $originalWebPath, // 可用于数据库存储
            'webp_db_path' => $webpWebPath, // 可用于数据库存储
        ], 200);
    }
}