不能直接 composer require php-hash-context，因为该包不存在；PHP 自 5.1.2 起内置 hash 扩展，需确认启用并使用 hash_init()/hash_update()/hash_final() 实现流式哈希。
为什么不能直接 composer require php-hash-context？
因为根本不存在名为 php-hash-context 的 Composer 包。这是常见误解——有人把 PHP 内置的 hash_init() / hash_update() / hash_final() 这组函数误当成独立扩展或第三方库。PHP 从 5.1.2 起就原生支持流式哈希，无需额外安装扩展（除非你用的是极老版本且没启用 hash 扩展）。
确认 hash 扩展已启用是前提
运行 php -m | grep hash，输出中必须有 hash；若无，需在 php.ini 中取消注释 extension=hash（Linux/macOS）或 extension=php_hash.dll（Windows），然后重启 PHP 进程。
检查是否可用的最小验证：
var_dump(function_exists('hash_init'));
返回 true 才能继续。否则所有流式哈希调用都会报 Call to undefined function hash_init() 错误。
立即学习“PHP免费学习笔记（深入）”；
用 hash_init() + fopen() 实现大文件流式哈希
核心思路：不把整个文件读进内存，而是分块读取、逐块更新哈希上下文。适用于 GB 级文件，内存占用稳定在几 KB。
-
hash_init('sha256')创建上下文，返回资源句柄 -
fopen($file, 'rb')以二进制模式打开文件（避免 Windows 下换行符干扰） - 用
fread($fp, 8192)每次读 8KB，传给hash_update($ctx, $chunk) - 循环结束后调用
hash_final($ctx)获取最终摘要
示例片段：
$ctx = hash_init('sha256');
$fp = fopen('/large/file.bin', 'rb');
while (!feof($fp)) {
$chunk = fread($fp, 8192);
hash_update($ctx, $chunk);
}
fclose($fp);
echo hash_final($ctx); // 输出 64 位十六进制字符串
注意 hash_update_stream() 的坑
PHP 提供了更简洁的 hash_update_stream()，但容易踩两个坑：
- 它会自动移动文件指针，如果文件已部分读取过，结果会错
- 第二个参数是资源（
fopen返回值），不是文件路径字符串——传字符串会静默失败
正确用法：
$ctx = hash_init('md5');
$fp = fopen('/path/to/file', 'rb');
hash_update_stream($ctx, $fp); // ✅ 传资源
fclose($fp);
echo hash_final($ctx);
错误写法：hash_update_stream($ctx, '/path/to/file') —— 这不会报错，但哈希值为空。
fread + hash_update，逻辑清晰、可控性强；hash_update_stream 适合简单场景，但务必确认参数类型和文件指针状态。流式哈希的关键不是“装什么包”，而是别让整个文件进内存。 
