md5_file() 函數的基礎用法詳解

M66 2025-06-02

在PHP開發中，文件的完整性校驗是一個非常常見的需求，尤其是在處理上傳文件、緩存文件或安全驗證時。 md5_file()函數正是用於計算文件的MD5哈希值，是一個簡單且實用的工具。本文將詳細介紹md5_file()函數的用法，並通過示例講解它在實際場景中的應用。

什麼是md5_file()函數？

md5_file()是PHP內置函數，用來計算指定文件的MD5散列值。 MD5（Message-Digest Algorithm 5）是一種廣泛使用的哈希函數，生成一個32位的十六進製字符串，用來唯一標識文件內容。

函數定義：

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

$filename ：必需，文件路徑。
$raw_output ：可選，是否以原始二進制格式輸出。默認false ，返回32位十六進製字符串。

函數返回文件內容的MD5值，失敗時返回false 。

md5_file()的基本用法

下面是一個最簡單的示例，計算某個文件的MD5值：

 <?php
$file = 'example.txt';
$md5 = md5_file($file);

if ($md5 !== false) {
    echo "文件 $file 的MD5值是：$md5";
} else {
    echo "無法讀取文件 $file";
}
?>

該示例中，我們傳入文件路徑example.txt ，並打印出文件的MD5值。如果文件不存在或無法讀取，則返回錯誤信息。

md5_file()在實際場景中的應用

1. 文件完整性驗證

在上傳文件時，客戶端可以先計算文件的MD5值，上傳後服務器端也計算一遍MD5，確認兩者一致，避免文件傳輸過程中的錯誤或篡改。

 <?php
// 假設客戶端上傳了文件，服務器端接收到文件路徑$uploadedFile

$serverMd5 = md5_file($uploadedFile);
$clientMd5 = $_POST['file_md5']; // 假設客戶端提交了md5值

if ($serverMd5 === $clientMd5) {
    echo "文件驗證成功，完整無誤。";
} else {
    echo "文件驗證失敗，文件可能被篡改。";
}
?>

2. 緩存文件變更檢測

在緩存系統中，可以利用文件的MD5值判斷文件是否被修改，決定是否更新緩存。

 <?php
$cacheFile = '/path/to/cache/data.cache';
$currentMd5 = md5_file($cacheFile);

if ($currentMd5 !== $storedMd5) {
    // 文件內容髮生變化，重新生成緩存
    regenerateCache();
    $storedMd5 = $currentMd5;
}
?>

3. 下載文件的安全校驗

通過md5_file()計算文件哈希，配合下載鏈接，可以防止非法下載或鏈接被篡改。

 <?php
$file = 'files/sample.zip';
$expectedMd5 = md5_file($file);

echo "點擊下載文件：<a href='https://m66.net/download.php?file=sample.zip&md5=$expectedMd5'>下載鏈接</a>";
?>

注意事項

md5_file()讀取整個文件內容進行計算，對於大文件性能會有影響，建議合理使用。
MD5算法已被證明存在碰撞風險，安全敏感場景推薦使用更安全的哈希算法（如hash_file('sha256', $filename) ）。
傳入的文件路徑必須可讀，否則返回false 。

通過本文，你已經掌握了md5_file()函數的基本使用方法和幾種典型應用場景。在實際開發中，結合文件校驗需求， md5_file()是一個非常便捷的工具。

md5_file