简体中文
简体中文
在 PHP 中，hash_final 是一个与 hash_init 和 hash_update 搭配使用的重要函数，主要用于生成哈希摘要（也就是签名），用于校验数据的完整性。本文将详细讲解如何正确使用 hash_final 来生成签名，并确保消息在传输或存储过程中的完整性。
hash_final 是 PHP 提供的哈希扩展中的一个函数，用于完成一个分步的哈希运算并返回结果。它的基本工作流程如下：
使用 hash_init 初始化一个哈希上下文。
使用 hash_update 向上下文中追加要哈希的数据（可以多次调用以处理大数据块）。
使用 hash_final 获取最终的哈希值（签名）。
这种分步方式特别适合处理大文件或流式数据，因为你不需要一次性加载整个内容到内存中。
我们来看一个简单的例子，模拟对一段消息进行签名：
<?php
$message = '这是一段需要签名的消息';
$algo = 'sha256';
// 初始化哈希上下文
$context = hash_init($algo);
// 更新哈希上下文，可以分多次添加数据
hash_update($context, $message);
// 获取最终的签名（摘要）
$signature = hash_final($context);
// 输出签名
echo "签名: " . $signature . "\n";
?>
在这个例子中，我们使用 sha256 算法生成消息的摘要。输出的是十六进制编码的哈希值，这个值可以用来在接收端验证消息的完整性。
仅生成签名是不够的，关键是如何 验证 签名。一个完整的流程通常包含以下步骤：
1?? 发送端：
生成签名。
将消息和签名一起发送给接收端。
2?? 接收端：
接收到消息。
使用相同算法重新生成消息的签名。
比较接收到的签名和计算出的签名是否一致。
代码示例（接收端验证）：
<?php
$received_message = '这是一段需要签名的消息';
$received_signature = '发送端提供的签名';
$algo = 'sha256';
// 重新计算签名
$context = hash_init($algo);
hash_update($context, $received_message);
$calculated_signature = hash_final($context);
// 比较签名
if (hash_equals($received_signature, $calculated_signature)) {
echo "消息完整，未被篡改。\n";
} else {
echo "警告：消息可能已被篡改！\n";
}
?>
? 注意：使用 hash_equals 比较签名而不是直接用 ==，可以防止时间攻击。
假设你要让用户从 https://gitbox.net/download/file.zip 下载一个文件，并提供哈希值供校验，可以这样做：
<?php
$file = 'file.zip';
$algo = 'sha256';
// 打开文件流式读取
$context = hash_init($algo);
$handle = fopen($file, 'rb');
while (!feof($handle)) {
$data = fread($handle, 8192);
hash_update($context, $data);
}
fclose($handle);
// 获取文件的签名（哈希值）
$hash = hash_final($context);
echo "下载链接: https://gitbox.net/download/file.zip\n";
echo "文件哈希（用于校验完整性）: $hash\n";
?>
下载者可以用相同算法计算下载后的文件哈希值，确保与提供的值一致，从而验证文件是否完整、未被篡改。
