PHP中验证Base64图片有效性的实用教程

function extractBase64Data(string $base64String): ?array
{
    // 匹配data URI格式：data:[<MIME-type>][;charset=<encoding>][;base64],<data>
    $pattern = '/^data:(?P<mime>[a-zA-Z0-9\/+\-\.]+);base64,(?P<data>[a-zA-Z0-9\/+\-=]+)$/';
    if (preg_match($pattern, $base64String, $matches)) {
        return [
            'mime' => $matches['mime'],
            'data' => $matches['data']
        ];
    }
    return null; // 不符合数据URI格式
}

// 假设 $extractedData['data'] 是从步骤一获取的纯Base64数据
$decodedData = base64_decode($extractedData['data'], true);

if ($decodedData === false) {
    // 解码失败，说明不是有效的Base64编码
    // ...
}

if ($decodedData !== false) {
    // 重新编码解码后的数据，并与原始Base64数据进行比较
    if (base64_encode($decodedData) === $extractedData['data']) {
        // Base64编码有效
        // ...
    } else {
        // 编码有效，但重新编码后不一致，可能存在填充问题或非标准Base64
        // 这种情况通常也被视为无效
        // ...
    }
}

<?php

/**
 * 验证Base64图片字符串的有效性
 *
 * @param string $base64String 完整的Base64数据URI字符串
 * @param array $allowedMimeTypes 允许的图片MIME类型列表，例如 ['image/jpeg', 'image/png']
 * @return bool 如果Base64图片有效且MIME类型符合要求，则返回true；否则返回false。
 */
function isValidBase64Image(string $base64String, array $allowedMimeTypes = []): bool
{
    // 1. 提取Base64编码数据和MIME类型
    $pattern = '/^data:(?P<mime>[a-zA-Z0-9\/+\-\.]+);base64,(?P<data>[a-zA-Z0-9\/+\-=]+)$/';
    if (!preg_match($pattern, $base64String, $matches)) {
        return false; // 不符合数据URI格式
    }

    $mimeType = $matches['mime'];
    $base64Data = $matches['data'];

    // 2. 验证MIME类型
    if (!empty($allowedMimeTypes) && !in_array($mimeType, $allowedMimeTypes)) {
        return false; // MIME类型不被允许
    }

    // 3. 严格解码Base64数据
    $decodedData = base64_decode($base64Data, true);

    if ($decodedData === false) {
        return false; // Base64解码失败，数据无效
    }

    // 4. 重新编码并比对，确保数据完整性和正确性
    // 这一步可以捕获一些虽然能解码但不完全符合标准Base64编码的情况
    if (base64_encode($decodedData) !== $base64Data) {
        return false; // 重新编码后不一致，数据可能不完整或格式不正确
    }

    // 5. （可选但推荐）进一步验证解码后的数据是否确实是图片
    // 这一步需要GD库或ImageMagick等扩展支持
    // 这里仅做示例，实际应用中可能需要更复杂的图像头检查
    // getimagesizefromstring() 函数可以检测字符串是否为有效的图片数据
    $imageInfo = @getimagesizefromstring($decodedData);
    if ($imageInfo === false) {
        return false; // 解码后的数据不是有效的图片
    }

    // 确保MIME类型与getimagesizefromstring检测到的MIME类型一致
    // 注意：getimagesizefromstring() 返回的MIME类型可能更具体，
    // 例如，对于'image/jpeg'，它可能返回'image/jpeg'。
    // 如果允许的MIME类型列表是通用的，可以跳过此严格检查。
    // 这里我们只确保它确实是图片
    if (!str_starts_with($imageInfo['mime'], 'image/')) {
        return false; // getimagesizefromstring 认为它不是图片
    }

    return true; // 所有验证通过
}

// 示例用法
$validJpeg = 'data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQoLCw4NDhwQEBw7KCIoOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozv/wAARCAABAAEDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAD/xAAUEAEAAAAAAAAAAAAAAAAAAAAA/8QAFAEBAAAAAAAAAAAAAAAAAAAAAP/EABQRAQAAAAAAAAAAAAAAAAAAAAD/2gAMAwEAAhEDEQA/AKoAAAH//Z';
$invalidBase64 = 'data:image/jpeg;base64,invalid-base64-string!';
$notAnImage = 'data:text/plain;base64,SGVsbG8sIFdvcmxkIQ=='; // "Hello, World!" in base64

$allowedTypes = ['image/jpeg', 'image/png', 'image/gif'];

if (isValidBase64Image($validJpeg, $allowedTypes)) {
    echo "'$validJpeg' 是一个有效的JPEG图片。\n";
} else {
    echo "'$validJpeg' 不是一个有效的JPEG图片。\n";
}

if (isValidBase64Image($invalidBase64, $allowedTypes)) {
    echo "'$invalidBase64' 是一个有效的图片。\n";
} else {
    echo "'$invalidBase64' 不是一个有效的图片。\n";
}

if (isValidBase64Image($notAnImage, $allowedTypes)) {
    echo "'$notAnImage' 是一个有效的图片。\n";
} else {
    echo "'$notAnImage' 不是一个有效的图片。\n";
}

$anotherValidPng = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII='; // 1x1 transparent PNG
if (isValidBase64Image($anotherValidPng, $allowedTypes)) {
    echo "'$anotherValidPng' 是一个有效的PNG图片。\n";
} else {
    echo "'$anotherValidPng' 不是一个有效的PNG图片。\n";
}

$invalidMimeType = 'data:application/pdf;base64,JVBERi0xLjQKJcOkwODA...'; // PDF base64
if (isValidBase64Image($invalidMimeType, $allowedTypes)) {
    echo "'$invalidMimeType' 是一个有效的图片。\n";
} else {
    echo "'$invalidMimeType' 不是一个有效的图片 (MIME类型不匹配)。\n";
}

?>