PHP怎么计算文件MD5_PHP生成文件MD5校验值教程

<?php

/**
 * 计算文件的MD5校验值
 *
 * @param string $filePath 文件的完整路径
 * @return string|false 返回文件的MD5校验值（32位十六进制字符串），如果文件不存在或无法读取则返回false
 */
function getFileMd5(string $filePath): string|false
{
    if (!file_exists($filePath)) {
        // 文件不存在，直接返回false，或者抛出异常，这取决于你的错误处理策略
        // 我个人倾向于在这里直接返回false，让调用者去判断
        error_log("文件不存在: " . $filePath);
        return false;
    }

    // 检查文件是否可读，虽然md5_file内部也会检查，但提前检查能让错误信息更明确
    if (!is_readable($filePath)) {
        error_log("文件不可读: " . $filePath);
        return false;
    }

    $md5 = md5_file($filePath);

    if ($md5 === false) {
        // md5_file失败，可能是文件权限问题或其他I/O错误
        error_log("计算文件MD5失败: " . $filePath);
    }

    return $md5;
}

// 示例用法：
$testFilePath = 'path/to/your/file.txt'; // 替换为你的实际文件路径

// 创建一个示例文件，方便测试
if (!file_exists($testFilePath)) {
    file_put_contents($testFilePath, "Hello, this is a test file for MD5 calculation.\n");
}

$fileMd5 = getFileMd5($testFilePath);

if ($fileMd5 !== false) {
    echo "文件 " . $testFilePath . " 的MD5校验值是: " . $fileMd5 . "\n";
} else {
    echo "无法计算文件 " . $testFilePath . " 的MD5校验值。\n";
}

// 如果文件内容发生变化，MD5也会变化
file_put_contents($testFilePath, "Hello, this is an updated test file for MD5 calculation.\nAnother line added.");
$updatedFileMd5 = getFileMd5($testFilePath);
if ($updatedFileMd5 !== false) {
    echo "更新后文件 " . $testFilePath . " 的MD5校验值是: " . $updatedFileMd5 . "\n";
}

// 再次计算一个不存在的文件的MD5
$nonExistentFile = 'path/to/non_existent_file.txt';
$nonExistentMd5 = getFileMd5($nonExistentFile);
if ($nonExistentMd5 === false) {
    echo "尝试计算不存在文件 " . $nonExistentFile . " 的MD5，结果符合预期：失败。\n";
}

?>

<?php

/**
 * 分块计算大文件的MD5校验值
 *
 * @param string $filePath 文件的完整路径
 * @param int $chunkSize 每次读取的字节数，默认为4MB
 * @return string|false 返回文件的MD5校验值，如果文件不存在或无法读取则返回false
 */
function getLargeFileMd5Chunked(string $filePath, int $chunkSize = 4096 * 1024): string|false
{
    if (!file_exists($filePath) || !is_readable($filePath)) {
        error_log("文件不存在或不可读: " . $filePath);
        return false;
    }

    $handle = fopen($filePath, 'rb'); // 以二进制读取模式打开文件
    if ($handle === false) {
        error_log("无法打开文件进行读取: " . $filePath);
        return false;
    }

    $context = hash_init('md5'); // 初始化MD5哈希上下文

    if ($context === false) {
        fclose($handle);
        error_log("无法初始化MD5哈希上下文");
        return false;
    }

    while (!feof($handle)) {
        $buffer = fread($handle, $chunkSize); // 读取指定大小的数据块
        if ($buffer === false) {
            fclose($handle);
            error_log("读取文件失败: " . $filePath);
            return false;
        }
        hash_update($context, $buffer); // 更新哈希上下文
    }

    fclose($handle); // 关闭文件句柄

    return hash_final($context); // 获取最终的MD5值
}

// 示例用法：
$largeFilePath = 'path/to/your/large_file.zip'; // 替换为你的大文件路径

// 为了测试，可以创建一个大文件
if (!file_exists($largeFilePath)) {
    // 创建一个10MB的随机文件
    $fp = fopen($largeFilePath, 'wb');
    if ($fp) {
        for ($i = 0; $i < 1024; $i++) { // 1024 * 10KB = 10MB
            fwrite($fp, random_bytes(10 * 1024));
        }
        fclose($fp);
        echo "创建了测试大文件: " . $largeFilePath . "\n";
    } else {
        echo "无法创建测试大文件: " . $largeFilePath . "\n";
    }
}


$largeFileMd5 = getLargeFileMd5Chunked($largeFilePath, 8192 * 1024); // 使用8MB的块大小

if ($largeFileMd5 !== false) {
    echo "大文件 " . $largeFilePath . " 的MD5校验值是: " . $largeFileMd5 . "\n";
} else {
    echo "无法计算大文件 " . $largeFilePath . " 的MD5校验值。\n";
}

?>

<?php

/**
 * 使用指定算法计算文件的哈希校验值
 *
 * @param string $filePath 文件的完整路径
 * @param string $algo 哈希算法名称（如'sha256', 'sha512', 'md5'）
 * @return string|false 返回文件的哈希校验值，如果文件不存在或无法读取则返回false
 */
function getFileHash(string $filePath, string $algo = 'sha256'): string|false
{
    if (!in_array($algo, hash_algos())) {
        error_log("不支持的哈希算法: " . $algo);
        return false;
    }

    if (!file_exists($filePath) || !is_readable($filePath)) {
        error_log("文件不存在或不可读: " . $filePath);
        return false;
    }

    $hash = hash_file($algo, $filePath);

    if ($hash === false) {
        error_log("计算文件哈希失败: " . $filePath);
    }

    return $hash;
}

// 示例用法：
$testFilePath = 'path/to/your/file.txt'; // 替换为你的实际文件路径

// 确保文件存在
if (!file_exists($testFilePath)) {
    file_put_contents($testFilePath, "This is a file for testing different hash algorithms.");
}

// 计算文件的SHA256校验值
$sha256 = getFileHash($testFilePath, 'sha256');
if ($sha256 !== false) {
    echo "文件 " . $testFilePath . " 的SHA256校验值是: " . $sha256 . "\n";
}

// 计算文件的SHA512校验值
$sha512 = getFileHash($testFilePath, 'sha512');
if ($sha512 !== false) {
    echo "文件 " . $testFilePath . " 的SHA512校验值是: " . $sha512 . "\n";
}

// 当然，你也可以用它来计算MD5，但出于安全性考虑，不再推荐
$md5 = getFileHash($testFilePath, 'md5');
if ($md5 !== false) {
    echo "文件 " . $testFilePath . " 的MD5校验值是 (不推荐用于安全场景): " . $md5 . "\n";
}

?>