PHP中验证Base64编码字符串有效性的实用指南

<?php

/**
 * 验证一个字符串是否为有效的Base64编码。
 * 支持纯Base64字符串和数据URI格式（如data:image/jpeg;base64,...）。
 *
 * @param string $inputString 待验证的字符串。
 * @return bool 如果是有效的Base64编码，则返回true；否则返回false。
 */
function isValidBase64String(string $inputString): bool
{
    // 1. 尝试从数据URI中提取Base64部分
    // 正则表达式匹配data:[<mediatype>][;base64],<data>
    if (preg_match('/^data:([a-zA-Z0-9]+\/[a-zA-Z0-9\-\.]+);base64,(.*)$/', $inputString, $matches)) {
        $base64_part = $matches[2]; // 提取Base64编码部分
    } else {
        $base64_part = $inputString; // 如果不是数据URI，则认为整个字符串就是Base64部分
    }

    // 2. 使用base64_decode进行解码，并启用严格模式
    // 严格模式下，如果字符串包含非Base64字符，将返回false
    $decoded_data = base64_decode($base64_part, true);

    // 3. 检查解码结果
    // 如果解码失败（返回false），则不是有效的Base64
    if ($decoded_data === false) {
        return false;
    }

    // 4. 将解码后的数据重新编码，并与原始Base64部分进行比较
    // 如果重新编码的结果与原始Base64部分不完全一致，则认为原始Base64部分是无效的
    // （例如，可能包含填充不正确的字符或额外的空白）
    return base64_encode($decoded_data) === $base64_part;
}

// 示例用法：

// 示例1: 有效的Base64数据URI
$validPicUri = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';
if (isValidBase64String($validPicUri)) {
    echo "示例1: \"$validPicUri\" 是有效的Base64编码。\n";
} else {
    echo "示例1: \"$validPicUri\" 不是有效的Base64编码。\n";
}

// 示例2: 有效的纯Base64字符串 (与示例1相同内容)
$validPicBase64 = 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';
if (isValidBase64String($validPicBase64)) {
    echo "示例2: \"$validPicBase64\" 是有效的Base64编码。\n";
} else {
    echo "示例2: \"$validPicBase64\" 不是有效的Base64编码。\n";
}

// 示例3: 包含无效字符的Base64字符串
$invalidCharBase64 = 'iVBORw0G0goAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=!'; // 包含'G'和'!'
if (isValidBase64String($invalidCharBase64)) {
    echo "示例3: \"$invalidCharBase64\" 是有效的Base64编码。\n";
} else {
    echo "示例3: \"$invalidCharBase64\" 不是有效的Base64编码。\n";
}

// 示例4: 格式不正确的Base64字符串（缺少必要的填充或长度不正确）
$malformedBase64 = 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAASUVORK5CYI'; // 长度不对
if (isValidBase64String($malformedBase64)) {
    echo "示例4: \"$malformedBase64\" 是有效的Base64编码。\n";
} else {
    echo "示例4: \"$malformedBase64\" 不是有效的Base64编码。\n";
}

// 示例5: 空字符串
$emptyString = '';
if (isValidBase64String($emptyString)) {
    echo "示例5: \"$emptyString\" 是有效的Base64编码。\n";
} else {
    echo "示例5: \"$emptyString\" 不是有效的Base64编码。\n";
}

// 示例6: 随机文本
$randomText = 'Hello World!';
if (isValidBase64String($randomText)) {
    echo "示例6: \"$randomText\" 是有效的Base64编码。\n";
} else {
    echo "示例6: \"$randomText\" 不是有效的Base64编码。\n";
}

?>