如何使用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