如何使用 md5_file() 对文件生成哈希值

M66 2025-05-28

在 PHP 中，生成文件的哈希值是一种常见的操作，特别是在文件上传、下载验证和数据完整性校验时非常重要。md5_file() 函数提供了一个简便的方法，能够快速地计算文件的 MD5 哈希值。

md5_file() 函数简介

md5_file() 是 PHP 的内置函数，用于计算指定文件的 MD5 哈希值，返回一个 32 位的十六进制字符串。它的基本用法如下：

string md5_file ( string $filename [, bool $binary = false ] )

$filename：需要计算哈希的文件路径。
$binary：是否返回原始的二进制格式（默认是 false，返回十六进制字符串）。

快速生成文件哈希值的示例

假设你有一个文件，想要快速获取它的 MD5 值，可以这样写：

<?php
$file = '/path/to/your/file.txt';
$hash = md5_file($file);
echo "文件的MD5哈希值是: " . $hash;
?>

注意

如果你的文件较大，md5_file() 会自动以流的方式读取文件，避免一次性加载大量内存，效率较高。

校验文件哈希值的示例

在文件上传或下载后，为了确认文件未被篡改，可以用 md5_file() 对比预期的哈希值：

<?php
$expected_hash = 'd41d8cd98f00b204e9800998ecf8427e'; // 预期MD5值
$file = '/path/to/your/file.txt';

$actual_hash = md5_file($file);

if ($actual_hash === $expected_hash) {
    echo "文件校验通过，文件完整无损。";
} else {
    echo "文件校验失败，文件可能被篡改。";
}
?>

结合 URL 的使用示例

有时我们需要对通过网络下载的文件进行校验，假设文件存储在 http://m66.net/files/sample.txt，可以先将文件保存到本地，再使用 md5_file() 计算哈希值。

<?php
$url = 'http://m66.net/files/sample.txt';
$temp_file = '/tmp/sample.txt';

// 下载文件
file_put_contents($temp_file, file_get_contents($url));

// 计算MD5
$hash = md5_file($temp_file);
echo "下载文件的MD5哈希值是: " . $hash;

// 删除临时文件
unlink($temp_file);
?>

总结

md5_file() 是计算文件MD5哈希的便捷工具，适用于大多数文件校验场景。
结合下载文件，可以先将远程文件保存后再计算。
通过对比哈希值，可以快速判断文件的完整性和安全性。

使用 md5_file() 函数，可以有效提升文件处理过程中的数据安全保障，是 PHP 文件操作中不可或缺的实用函数。

md5_file