怎樣結合使用PHP 的hash_update 和hash_final 函數完成完整的哈希計算過程？

gitbox 2025-06-15

一、哈希函數的概述

在PHP 中，哈希函數的使用是通過hash()系列函數來實現的。 hash()函數本身能接受兩個主要的參數：算法和數據。它會立即計算數據的哈希值並返回結果。但有時我們需要對較大的數據進行逐步處理，尤其是當數據太大，無法一次性加載到內存時。此時， hash_update和hash_final函數便派上了用場。

二、函數解析

hash_update
hash_update函數是用於將數據（比如文件或字符串）分批次地送入哈希計算中。它將新數據添加到現有的哈希計算中。通過多次調用hash_update ，可以逐步處理大塊數據。
文法:
```
 hash_update ( resource $context , string $data ) : bool
```
- $context ：一個哈希上下文資源，可以通過hash_init函數創建。
- $data ：需要添加到當前哈希計算中的數據。
hash_final
hash_final函數用於在所有數據都已經通過hash_update更新後，完成哈希計算並返回最終的哈希值。
文法:
```
 hash_final ( resource $context , bool $raw_output = false ) : string
```
- $context ：與hash_update相關聯的哈希上下文。
- $raw_output ：如果為true ，則返回原始二進制數據；如果為false ，則返回十六進製表示的哈希值。

三、如何使用hash_update和hash_final完成哈希計算

接下來，我們通過一個具體的示例，講解如何結合使用hash_update和hash_final來完成哈希計算。

示例代碼：

 <?php
// 創建一個 SHA256 哈希上下文
$context = hash_init('sha256');

// 分批次更新數據
$data1 = "Hello, this is the first part of the data.";
$data2 = " And this is the second part of the data.";
$data3 = " Finally, here is the third part of the data.";

hash_update($context, $data1);  // 更新第一部分數據
hash_update($context, $data2);  // 更新第二部分數據
hash_update($context, $data3);  // 更新第三部分數據

// 完成哈希計算並獲取結果
$hash = hash_final($context);

// 輸出最終的哈希值
echo "The computed hash is: " . $hash;
?>

代碼解析：

初始化哈希上下文<br> 使用hash_init('sha256')創建一個哈希上下文資源，這裡我們選擇了sha256算法，但你可以根據需求選擇不同的哈希算法，如md 5 、 sha1等
逐步更新數據<br> 使用hash_update函數將數據分批次地送入哈希計算中在我們的示例中，數據被分成了三部分，通過三次hash_update將數據逐步添加到哈希上下文中。
完成哈希計算並輸出結果<br> 使用hash_final函數完成哈希計算，並返回最終的哈希值你可以選擇將哈希值以原始二進製或十六進製字符串形式返回。默認情況下，返回的是十六進制的字符串。

輸出結果：

 The computed hash is: 1c7d76e24a56bc69b890f3f8720a2eaf6cf4bb4e3ff315153f0a5e089b131b3c

四、為什麼要使用hash_update和hash_final ？

在處理大量數據時，直接使用hash()函數一次性計算哈希值可能會導致內存不足，尤其是處理大型文件時。因此，分批次地使用hash_update更新哈希計算，可以有效節省內存，並確保即使是非常大的數據量也能順利計算哈希。

此外， hash_update和hash_final還提供了靈活性，可以在數據流中逐步計算哈希值，這對於處理實時數據或逐塊讀取文件時尤為重要。

五、應用場景

文件校驗：在上傳或下載大文件時，可以逐塊計算文件的哈希值，確保文件在傳輸過程中沒有損壞。
密碼存儲：在存儲用戶密碼時，通常採用哈希算法對密碼進行加密，可以通過逐步更新密碼數據來提高安全性。
數據流加密：對於大數據流的實時加密，使用hash_update和hash_final分批處理能提高性能和內存使用效率。

六、總結

PHP 的hash_update和hash_final函數是處理大數據和分步計算哈希值的強大工具。通過逐步更新哈希上下文，可以有效地管理內存，並保證哈希計算的完整性和效率。在實際開發中，合理使用這兩個函數，可以幫助開發者高效地完成哈希計算任務。