php 8.6的sodium扩展新增shake256状态式接口,可以分块读取文件,再固定提取32字节输出作为文件指纹。需要libsodium 1.0.21或更新版本;输出长度是协议的一部分,两端必须一致。shake256指纹适合完整性比对,不是密码存储方案,也不能在没有密钥认证的情况下证明文件来自可信发送方。

PHP8.6 Sodium官方源码中的SHAKE256状态初始化、更新与输出接口
固定文件与输出长度,避免整文件读入内存
<?php
if (!function_exists('sodium_crypto_xof_shake256_init')) {
throw new RuntimeException('需要PHP 8.6和libsodium 1.0.21+');
}
$file = __DIR__ . '/report.bin';
$fp = fopen($file, 'rb');
if ($fp === false) throw new RuntimeException('不能打开待比对文件');
try {
$state = sodium_crypto_xof_shake256_init();
while (!feof($fp)) {
$chunk = fread($fp, 65536);
if ($chunk === false) throw new RuntimeException('文件读取失败');
if ($chunk === '') {
if (feof($fp)) break;
throw new RuntimeException('文件读取没有进展');
}
sodium_crypto_xof_shake256_update($state, $chunk);
}
$digest = bin2hex(sodium_crypto_xof_shake256_squeeze($state, 32));
echo json_encode(['algorithm' => 'SHAKE256', 'output_bytes' => 32,
'digest_hex' => $digest], JSON_THROW_ON_ERROR), PHP_EOL;
} finally { fclose($fp); }在脚本同目录放置受控的report.bin再执行,空文件也可以计算。输出32个原始字节经十六进制编码后是64个字符,不能把字符数误认为算法输出字节数。分块大小65536用于控制读取内存,不会改变同一文件和同一算法设置的最终指纹。

PHP官方SHAKE256测试验证分块更新与一次性计算一致,并检查零长度错误
只在内容稳定时做比对
生成指纹期间文件被其他进程修改,结果可能不对应任何一个完整版本。应对固定版本文件计算,必要时由写入流程先完成并切换为只读快照。网络文件、无限流或设备文件另外需要总字节和时间限制,不能把这个本地有限文件循环直接用于任意输入。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
同一SHAKE状态再次squeeze会继续输出后续字节,不是重新得到同一个摘要。因此每个文件新建状态,只在读完后提取一次约定长度。分块指纹只证明比较到的字节是否一致,可信预期值仍需通过受保护渠道取得。


















