简体中文
简体中文
在文件传输或下载过程中，尤其是大文件的传输，常常会遇到中断的情况。为了确保文件的完整性，在文件传输过程中通常会对文件进行哈希验证。PHP 提供了强大的哈希功能，hash_update_stream 函数便是其中之一，它可以用来处理大文件的哈希计算，特别适用于断点续传文件的验证。
本文将介绍如何使用 hash_update_stream 实现文件的哈希完整性验证，确保文件在中断后继续下载时能进行完整性校验。
hash_update_stream 函数是 PHP 中用来在读取流数据的过程中计算哈希值的函数。与 hash_update 不同，后者需要将整个数据一次性加载到内存中，而 hash_update_stream 则可以逐步读取文件流进行哈希计算，因此特别适合用于大文件或者需要分块处理的文件。
bool hash_update_stream ( resource $context , resource $stream [, int $length ] )
在文件传输过程中，若传输中途断开，断点续传机制会从断开的位置继续下载。为了验证断点续传后的文件完整性，通常会在服务器端计算文件的哈希值并与客户端传输的哈希值进行对比。
假设你有一个断点续传下载的文件 bigfile.zip，你需要验证该文件是否在传输过程中被篡改或者丢失部分内容。下面是实现哈希完整性验证的步骤。
假设我们需要下载一个文件 bigfile.zip，并且验证文件在断点续传时的完整性。以下代码展示了如何在断点续传过程中使用 hash_update_stream 函数计算文件的哈希。
<?php
// 初始哈希上下文（使用 SHA256 算法）
$hashContext = hash_init('sha256');
// 打开文件流
$fileStream = fopen('https://m66.net/bigfile.zip', 'rb');
if (!$fileStream) {
die("无法打开文件！\n");
}
// 计算文件的哈希值
while (!feof($fileStream)) {
// 读取文件并更新哈希
$data = fread($fileStream, 8192);
hash_update_stream($hashContext, $data);
}
// 获取最终的哈希值
$fileHash = hash_final($hashContext);
// 输出文件的哈希值
echo "文件的SHA-256哈希值：$fileHash\n";
// 关闭文件流
fclose($fileStream);
// 假设已经在服务器端生成并存储了文件的正确哈希值
$serverStoredHash = 'abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890';
// 比较本地计算的哈希值与服务器存储的哈希值
if ($fileHash === $serverStoredHash) {
echo "文件完整性验证成功！\n";
} else {
echo "文件验证失败，文件可能已经损坏或被篡改！\n";
}
?>
hash_init：初始化一个哈希上下文，选择 sha256 算法来生成哈希值。
fopen：打开待下载的文件流，在这里我们使用 https://m66.net/bigfile.zip 作为示例文件地址。
hash_update_stream：逐步读取文件的每一块数据并更新哈希值。每次读取的数据块大小为 8192 字节。
hash_final：获取文件的最终哈希值。
文件验证：将计算出的哈希值与服务器上存储的正确哈希值进行对比，从而验证文件的完整性。
在断点续传的场景中，我们通常会存储一个“已下载的部分”哈希值，并且在继续下载时接着计算从上次断点处开始的文件部分的哈希。为此，代码中的 fread 可以配合 fseek 来控制文件的读取位置，从而确保从指定位置开始计算。
// 设置文件流指针到指定位置（比如断点续传的部分）
fseek($fileStream, $resumePosition);
在继续下载时，我们从 resumePosition 位置开始继续读取数据块并更新哈希，最终验证整个文件的完整性。
通过使用 hash_update_stream，PHP 提供了一个高效的方式来计算大文件的哈希值，尤其适用于断点续传的文件传输过程中。通过这种方式，我们能够确保文件在传输过程中的完整性与正确性，避免文件在中途断开后出现数据丢失或损坏的情况。
如果你正在开发一个需要支持断点续传的文件下载或上传系统，结合 hash_update_stream 函数进行哈希验证，将为你提供一个可靠的数据完整性保障。
