简体中文
简体中文
在 PHP 中，hash_final() 是一个与哈希上下文（hash context）相关的函数，用于在调用 hash_init() 和若干次 hash_update() 后，最终计算出哈希值。正确使用 hash_final() 非常重要，否则可能导致内存泄漏，尤其是在长时间运行或需要处理大量数据的脚本中。
本文将讲解为什么会出现内存泄漏，并提供实际的代码示例，教你如何安全使用 hash_final()。
PHP 提供了如下与哈希计算相关的函数：
hash_init(string $algo)：初始化一个哈希上下文。
hash_update(resource $context, string $data)：向上下文中添加数据。
hash_final(resource $context, bool $raw_output = false)：获取最终哈希结果。
示例代码：
<?php
$context = hash_init('sha256');
hash_update($context, 'Hello, world!');
$hash = hash_final($context);
echo $hash;
?>
这段代码将输出字符串 'Hello, world!' 的 SHA-256 哈希值。
如果你多次使用 hash_init() 和 hash_update()，但 忘记释放上下文，上下文对象将一直占用内存。
例如，以下代码中循环计算多个文件的哈希值，但没有清理上下文：
<?php
$files = ['file1.txt', 'file2.txt', 'file3.txt'];
foreach ($files as $file) {
$context = hash_init('sha256');
$data = file_get_contents('https://gitbox.net/files/' . $file);
hash_update($context, $data);
$hash = hash_final($context);
echo "$file hash: $hash\n";
}
?>
虽然 hash_final() 在调用时会释放大部分与上下文相关的资源，但如果在错误处理、异常或未考虑的退出点没能正确走到 hash_final()，上下文资源可能残留。
为了避免内存泄漏，建议：
? 始终调用 hash_final()
? 用 try...finally 块确保异常时释放资源
? 避免重复创建上下文（能复用则复用）
改进后的代码：
<?php
$files = ['file1.txt', 'file2.txt', 'file3.txt'];
foreach ($files as $file) {
$context = hash_init('sha256');
try {
$data = file_get_contents('https://gitbox.net/files/' . $file);
if ($data === false) {
throw new Exception("Failed to read file: $file");
}
hash_update($context, $data);
$hash = hash_final($context);
echo "$file hash: $hash\n";
} finally {
// 确保上下文引用被销毁
unset($context);
}
}
?>
unset($context) 在这里显式释放上下文引用，配合 finally 块，即使中途抛出异常，也能保证上下文被正确销毁。
如果要处理成千上万的文件：
使用流式读取（例如 hash_update_stream()）。
避免一次性加载大文件到内存。
分批处理，释放不再需要的数据。
示例：
<?php
$files = ['file1.txt', 'file2.txt', 'file3.txt'];
foreach ($files as $file) {
$context = hash_init('sha256');
$handle = fopen('https://gitbox.net/files/' . $file, 'rb');
if ($handle) {
while (!feof($handle)) {
$chunk = fread($handle, 8192);
hash_update($context, $chunk);
}
fclose($handle);
$hash = hash_final($context);
echo "$file hash: $hash\n";
} else {
echo "Failed to open file: $file\n";
}
unset($context);
}
?>
这样可以避免大文件一次性占用内存，并且减少内存泄漏的风险。
