PHP中利用Imagick与gif2webp高效转换动画GIF为WebP教程

sudo apt update
sudo apt install webp

brew install webp

<?php

// 确保错误报告开启，便于调试
error_reporting(E_ALL);
ini_set('display_errors', 1);

/**
 * 将上传的图像文件转换为WebP格式。
 * 对于动画GIF，使用gif2webp命令行工具；
 * 对于其他静态图像，使用Imagick库。
 *
 * @param array $fileData $_FILES 数组中对应的文件信息
 * @param string $destinationPath 转换后WebP文件的保存路径（包含文件名）
 * @return bool 转换成功返回true，否则返回false
 */
function convertImageToWebP(array $fileData, string $destinationPath): bool
{
    // 检查文件上传是否成功
    if ($fileData['error'] !== UPLOAD_ERR_OK) {
        error_log("文件上传错误: " . $fileData['error']);
        return false;
    }

    $tmpFilePath = $fileData['tmp_name'];

    // 使用finfo获取文件的MIME类型
    $finfo = new finfo(FILEINFO_MMIME_TYPE);
    $fileType = $finfo->file($tmpFilePath);

    // 确定目标WebP文件的完整路径
    $outputWebpPath = $destinationPath;

    // 根据文件类型选择转换方法
    if ($fileType === 'image/gif') {
        // 这是一个GIF文件，可能是动画GIF，使用gif2webp
        // 首先将上传的GIF文件移动到临时位置，以便gif2webp处理
        $tempGifPath = sys_get_temp_dir() . '/' . uniqid('uploaded_gif_') . '.gif';
        if (!move_uploaded_file($tmpFilePath, $tempGifPath)) {
            error_log("无法将GIF文件移动到临时目录: " . $tempGifPath);
            return false;
        }

        // 构建gif2webp命令
        // -q 80: 设置输出质量为80 (0-100)
        // -o: 指定输出文件路径
        // 注意：确保gif2webp在系统PATH中，或者使用完整路径，例如 '/usr/bin/gif2webp'
        $command = "gif2webp -q 80 " . escapeshellarg($tempGifPath) . " -o " . escapeshellarg($outputWebpPath);

        // 执行命令
        $output = [];
        $return_var = 0;
        exec($command, $output, $return_var);

        // 清理临时GIF文件
        if (file_exists($tempGifPath)) {
            unlink($tempGifPath);
        }

        if ($return_var === 0 && file_exists($outputWebpPath)) {
            return true; // 转换成功
        } else {
            error_log("gif2webp转换失败。命令: {$command}, 输出: " . implode("\n", $output) . ", 返回码: {$return_var}");
            return false; // 转换失败
        }

    } else {
        // 其他图像类型（JPEG, PNG等），使用Imagick
        try {
            $imagick = new Imagick($tmpFilePath);
            $imagick->setImageFormat('webp');
            $imagick->setImageCompressionQuality(80); // 设置压缩质量
            $imagick->setOption('webp:lossless', 'false'); // 可以选择有损或无损

            $imagick->writeImage($outputWebpPath);
            $imagick->clear();
            $imagick->destroy();
            return true;
        } catch (ImagickException $e) {
            error_log("Imagick转换失败: " . $e->getMessage());
            return false;
        }
    }
}

// 示例用法 (假设您有一个表单上传文件，字段名为 'profileImg')
if (isset($_FILES['profileImg'])) {
    $uploadDir = __DIR__ . '/uploads/'; // 定义上传目录
    if (!is_dir($uploadDir)) {
        mkdir($uploadDir, 0777, true); // 如果目录不存在则创建
    }

    $originalFileName = pathinfo($_FILES['profileImg']['name'], PATHINFO_FILENAME);
    $webpFileName = $originalFileName . '.webp';
    $fullDestinationPath = $uploadDir . $webpFileName;

    if (convertImageToWebP($_FILES['profileImg'], $fullDestinationPath)) {
        echo "文件成功转换为WebP并保存到: " . $fullDestinationPath;
    } else {
        echo "文件转换失败。";
    }
} else {
    echo "请通过表单上传文件。";
}

?>