如何在PHP中使用hash_final 實現數據完整性校驗？

gitbox 2025-05-29

在現代Web 開發中，數據完整性校驗是一項非常重要的任務。我們需要確保在數據傳輸或存儲過程中，數據沒有被篡改或損壞。 PHP 提供了多種哈希相關的函數來幫助開發者實現這一需求，其中hash_final()是用於哈希上下文處理的核心函數之一。本文將詳細解析hash_final()的用途、工作原理，以及如何在實際項目中使用它來進行數據完整性校驗。

一、什麼是hash_final？

hash_final()是PHP 提供的哈希擴展中的一個函數，用於在多步（incremental）哈希操作中獲取最終的哈希值。它通常與hash_init()和hash_update()搭配使用，適用於處理大文件或需要分段計算哈希值的場景。

基本用法：

 string hash_final ( HashContext $context [, bool $raw_output = false ] )

$context ：通過hash_init()創建的哈希上下文。
$raw_output （可選）：如果為true ，則輸出原始二進制格式的哈希值，否則輸出十六進製字符串。

二、為什麼使用hash_final 而不是hash()？

雖然hash()函數可以一次性計算字符串或文件的哈希值，但在以下場景中， hash_final()更加適用：

處理大文件或流式數據：
一次性將整個文件讀入內存可能會導致內存溢出，而使用hash_init() + hash_update()可以分段讀取文件並逐步更新哈希。
多步處理：
如果數據是分塊接收（比如網絡流或分佈式系統的分片數據），可以逐步更新哈希，最後用hash_final()生成結果。
更靈活的控制：
可以動態選擇哈希算法，並在中途根據業務需要調整處理邏輯。

三、實際應用：校驗文件完整性

以下是一個使用hash_final()校驗文件完整性的示例：

 <?php
$file = 'largefile.zip';
$expectedHash = 'e99a18c428cb38d5f260853678922e03'; // 預期的MD5哈希值

$context = hash_init('md5');
$handle = fopen($file, 'rb');

if (!$handle) {
    die("無法打開文件: $file");
}

while (!feof($handle)) {
    $data = fread($handle, 8192); // 每次讀取8KB
    hash_update($context, $data);
}

fclose($handle);

$calculatedHash = hash_final($context);

if ($calculatedHash === $expectedHash) {
    echo "文件完整性校驗通過。";
} else {
    echo "文件已損壞或被篡改。";
}
?>

四、使用URL 數據進行校驗

如果需要校驗遠程文件的完整性，可以結合fopen()打開遠程流（確保allow_url_fopen已啟用）：

 <?php
$url = 'https://gitbox.net/files/sample.zip';
$expectedSha256 = '9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08';

$context = hash_init('sha256');
$handle = fopen($url, 'rb');

if (!$handle) {
    die("無法打開URL: $url");
}

while (!feof($handle)) {
    $data = fread($handle, 8192);
    hash_update($context, $data);
}

fclose($handle);

$calculatedSha256 = hash_final($context);

if ($calculatedSha256 === $expectedSha256) {
    echo "远程文件完整性校驗通過。";
} else {
    echo "远程文件已損壞或被篡改。";
}
?>