使用md5_file() 檢測上傳文件是否為已知惡意文件

M66 2025-05-29

在網站開發中，文件上傳功能是一個常見且重要的模塊，但它同時也帶來了安全隱患。攻擊者可能上傳惡意文件，危害服務器安全。為了防範這類風險，常用的一種方法是通過文件的哈希值（例如MD5）來判斷上傳文件是否為已知的惡意文件。

本文將介紹如何利用PHP 內置函數md5_file() ，結合已知惡意文件的MD5 值列表，來判斷上傳的文件是否存在風險。

1. md5_file() 簡介

md5_file()是PHP 中的一個函數，用於計算指定文件的MD5 哈希值。與md5()不同， md5()是對字符串進行哈希，而md5_file()是對文件內容直接計算哈希，適合用來檢測文件是否一致。

用法示例：

 $hash = md5_file('/path/to/file.txt');
echo $hash;

返回值是文件內容的32 位十六進制MD5 值。

2. 實現思路

維護一個已知惡意文件的MD5 哈希值列表，存儲在數組或數據庫中。
用戶上傳文件後，先將文件保存到臨時目錄。
使用md5_file()計算該文件的哈希值。
判斷哈希值是否在惡意列表中。
如果存在，則拒絕上傳或刪除該文件；否則允許上傳。

3. 代碼示例

以下示例演示了一個簡單的文件上傳並檢測惡意文件的流程：

 <?php
// 已知惡意文件的 MD5 列表（示例）
$malicious_md5_list = [
    'd41d8cd98f00b204e9800998ecf8427e', // 空文件示例
    '5d41402abc4b2a76b9719d911017c592', // 其他惡意文件示例
];

// 判斷上傳是否有文件
if (isset($_FILES['upload_file']) && $_FILES['upload_file']['error'] === UPLOAD_ERR_OK) {
    $tmpFilePath = $_FILES['upload_file']['tmp_name'];

    // 計算文件的 MD5 值
    $fileMd5 = md5_file($tmpFilePath);

    // 檢查是否為惡意文件
    if (in_array($fileMd5, $malicious_md5_list)) {
        echo "上傳的文件被檢測為已知的惡意文件，上傳失敗。";
        // 可選擇刪除臨時文件或記錄日誌
        unlink($tmpFilePath);
    } else {
        // 將文件移動到目標目錄
        $destination = __DIR__ . '/uploads/' . basename($_FILES['upload_file']['name']);
        if (move_uploaded_file($tmpFilePath, $destination)) {
            echo "文件上傳成功。";
        } else {
            echo "文件保存失敗。";
        }
    }
} else {
    echo "未檢測到上傳文件或上傳出錯。";
}
?>

4. 注意事項

惡意文件庫更新：維護一個最新的惡意文件哈希庫很重要，建議定期更新。
MD5 碰撞風險：MD5 已被證明存在碰撞風險，極端情況下攻擊者可能構造出相同哈希的文件。可以考慮使用更安全的哈希函數如SHA256（使用hash_file('sha256', $file) ）。
多重檢測機制：不要只依賴哈希檢測，最好結合文件類型驗證、文件擴展名限制、內容掃描（如殺毒軟件）等多重措施。
權限安全：上傳目錄需設置合理權限，防止直接執行惡意文件。

5. 小結

利用PHP 的md5_file()函數，可以快速判斷上傳文件的內容是否與已知惡意文件匹配，幫助提升上傳文件安全性。結合完善的惡意文件哈希庫和多重防護措施，能夠有效防止惡意文件對服務器造成危害。

md5_file
md5