使用md5_file() 校驗圖像文件時的最佳實踐

M66 2025-06-02

在PHP 中， md5_file()函數是一個非常實用的工具，用於計算文件的MD5 散列值。通過比較文件的散列值，我們可以有效檢測圖像文件是否被篡改。本文將詳細介紹如何利用md5_file()函數確保圖像文件的完整性。

什麼是md5_file()？

md5_file()函數會計算指定文件的MD5 散列值，返回一個32 位的十六進製字符串。 MD5 是一種常見的哈希算法，常用於文件校驗。即使文件只發生了極小的變化，MD5 值都會大幅不同。

函數原型：

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

$filename ：需要計算散列值的文件路徑。
$raw_output ：如果為true ，返回原始二進制格式；默認false返回十六進製字符串。

為什麼用md5_file() 檢測圖像文件完整性？

圖像文件在傳輸、存儲過程中可能被惡意篡改或意外損壞。通過保存圖像文件的原始MD5 值，我們可以在後續使用時重新計算並對比，一旦MD5 值不一致，即可判斷文件被篡改或損壞。

示例：用md5_file() 檢查圖像文件完整性

假設你有一張圖片image.jpg ，在上傳時保存它的MD5 值到數據庫或文本文件。然後每次使用這張圖片時重新計算MD5，進行對比。

第一步：計算並保存圖像MD5 值

<?php
$imagePath = 'uploads/image.jpg';
$md5Hash = md5_file($imagePath);

echo "圖像文件的 MD5 值是：".$md5Hash;

// 通常這裡會把 $md5Hash 保存到數據庫或文件中，方便後續校驗
?>

第二步：對比並檢測圖像是否被篡改

<?php
$imagePath = 'uploads/image.jpg';

// 從數據庫或文件中讀取之前保存的MD5值
$originalMd5 = 'd41d8cd98f00b204e9800998ecf8427e';  // 示例MD5值

$currentMd5 = md5_file($imagePath);

if ($currentMd5 === $originalMd5) {
    echo "圖像文件未被篡改。";
} else {
    echo "警告：圖像文件可能已被篡改！";
}
?>

結合遠程URL文件進行校驗

有時圖像文件存在於遠程服務器上，可以先下載文件內容，再計算MD5。

 <?php
$url = 'https://m66.net/path/to/image.jpg';
$tempFile = 'temp_image.jpg';

// 下載遠程文件到本地臨時文件
file_put_contents($tempFile, file_get_contents($url));

// 計算下載文件的MD5值
$remoteMd5 = md5_file($tempFile);

echo "远程圖像文件的 MD5 值：".$remoteMd5;

// 刪除臨時文件
unlink($tempFile);
?>

小結

使用md5_file()計算文件的MD5 散列值，可以方便檢測文件是否被篡改。
保存原始文件的MD5 值，後續對比以確保文件完整。
可應用於本地文件，也可以先下載遠程文件再計算。
該方法適合檢測文件被修改，但不能防止篡改，只能作為完整性校驗手段。

md5_file