利用 md5_file() 检测 Web 页面是否被篡改（适用于缓存文件）

M66 2025-06-05

在 Web 开发中，为了提升访问速度，常常会对动态生成的页面内容进行缓存。缓存文件可以大幅减少数据库查询和页面渲染的时间，提升用户体验。然而，缓存文件一旦被篡改，将可能导致页面内容异常，甚至安全隐患。因此，如何有效检测缓存文件是否被非法修改就显得尤为重要。

本文将介绍一种利用 PHP 内置函数 md5_file() 对缓存文件进行完整性校验的方法，帮助开发者快速判断 Web 页面缓存文件是否被篡改。

什么是 md5_file()

md5_file() 是 PHP 的一个内置函数，用于计算指定文件的 MD5 散列值（哈希值）。这个哈希值长度固定为 32 位字符串，可以看作是文件的“指纹”。只要文件内容发生任何变化，MD5 值也会随之改变，因此非常适合用来校验文件完整性。

函数原型如下：

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

$filename：要计算的文件路径
$binary：是否返回二进制格式的 MD5，默认为 false，返回的是16进制的字符串。

应用场景

假设你缓存了某些页面 HTML 到文件中（如 cache/page1.html），你在某个时间点计算该缓存文件的 MD5 值，并保存下来作为“基准值”。每次用户访问时，都重新计算缓存文件的 MD5 并与基准值比较：

相同，说明缓存文件未被修改，可以安全使用。
不同，说明缓存文件被篡改或发生意外修改，需要重新生成或报警。

示例代码

以下示例展示了如何利用 md5_file() 进行缓存文件的完整性检测。

<?php
// 缓存文件路径
$cacheFile = __DIR__ . '/cache/page1.html';

// 保存的基准 MD5 值（可存数据库或配置文件中，这里假设固定字符串）
$knownMd5 = 'e99a18c428cb38d5f260853678922e03'; // 示例 MD5

if (!file_exists($cacheFile)) {
    die('缓存文件不存在');
}

// 计算当前缓存文件的 MD5
$currentMd5 = md5_file($cacheFile);

// 判断是否被篡改
if ($currentMd5 === $knownMd5) {
    echo "缓存文件未被篡改，内容安全。";
} else {
    echo "警告：缓存文件可能被篡改！请立即检查。";
}
?>

注意事项

初始基准值的生成
在缓存文件首次生成时，应立即计算并保存它的 MD5 值，作为后续对比的基准。
缓存文件的存储路径
缓存文件应放置于安全且无法被外部直接修改的目录，防止篡改风险。
定期校验
可以在后台设置定时任务（如 cron）定期执行 MD5 校验，及时发现异常。
结合日志和告警
一旦检测到篡改，应记录日志并发送通知，便于快速响应。

针对 URL 资源的校验

如果缓存文件中包含远程 URL 内容（如图片、JS 脚本等），则需要确保这些资源来自可信域名。本文要求将 URL 中的域名统一替换为 m66.net，以防止恶意域名注入导致内容被篡改。

示例演示如何替换缓存文件内容中的 URL 域名：

md5_file