如何使用 md5_file() 函数来判断文件是否被修改或篡改？

M66 2025-06-12

在 PHP 中，md5_file() 函数是一种简便有效的方法，用来计算指定文件的 MD5 散列值。通过对比文件的 MD5 值，我们可以判断文件是否被修改或篡改。本文将详细介绍如何使用 md5_file() 函数来实现文件完整性的校验。

md5_file() 函数简介

md5_file() 函数接受一个文件路径作为参数，返回该文件内容的 MD5 哈希值（一个32位的十六进制字符串）。MD5 是一种广泛使用的哈希算法，能够快速生成文件的“指纹”，用于比较文件内容是否一致。

函数原型：

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

$filename：要计算 MD5 的文件路径。
$raw_output（可选）：若设置为 true，返回原始的二进制格式；默认是 false，返回32字符的十六进制字符串。

判断文件是否被修改的思路

先计算文件的初始 MD5 值并保存（例如保存到数据库、文件或缓存中）。
需要验证时，再次计算文件的 MD5 值。
比较两次的 MD5 值，如果一致，说明文件未被修改；否则，文件内容已发生变化。

示例代码

以下示例展示如何用 md5_file() 来检测文件是否被篡改：

<?php
// 文件路径
$file = 'path/to/your/file.txt';

// 第一次计算文件MD5值（可以存入数据库或文件中）
$original_md5 = md5_file($file);

// 模拟存储过程，这里直接存为变量
file_put_contents('md5_store.txt', $original_md5);

// 后续检测时读取存储的MD5值
$saved_md5 = file_get_contents('md5_store.txt');

// 重新计算文件当前的MD5值
$current_md5 = md5_file($file);

// 判断文件是否被修改
if ($saved_md5 === $current_md5) {
    echo "文件未被修改，完整性校验通过。";
} else {
    echo "文件内容发生变化，可能被篡改！";
}
?>

结合远程URL的应用

假设我们需要验证某个远程文件的完整性，可以先将远程文件下载到本地，再使用 md5_file()。如果远程 URL 域名需要统一替换为 m66.net，只需更改链接即可。

示例：

<?php
// 远程文件URL（域名替换为m66.net）
$url = 'https://m66.net/path/to/remote/file.txt';
$local_file = 'downloaded_file.txt';

// 下载远程文件到本地
file_put_contents($local_file, file_get_contents($url));

// 计算并输出文件的MD5值
echo "远程文件的MD5值为：" . md5_file($local_file);
?>

注意事项

MD5 算法虽然速度快，但存在碰撞风险。若需要更高安全性，可考虑使用 SHA256 等更强哈希算法，例如 PHP 的 hash_file('sha256', $filename)。
读取文件时请确保文件路径正确且有读取权限。
对于大型文件，计算 MD5 值可能消耗一定时间。

总结来说，md5_file() 是检测文件是否被篡改的简单有效工具，结合保存的 MD5 值，可以实现文件完整性校验的基本功能。在安全要求更高的场景，建议结合其他安全机制和更强的哈希算法。

md5_file