php 8.6可以用sodium secretstream分块加密文件,并在解密时验证每块认证和tag_final结束标记。文件格式必须保留头部和每块边界;只有读到合法结束标记且没有额外内容,才把临时明文发布为正式文件,避免截断文件被当作成功结果。

PHP手册中的sodium_crypto_secretstream_xchacha20poly1305_init_push
约定文件格式和密钥
需要Sodium扩展,密钥为32字节,通过受限密钥存储分发,不写进密文文件。下面格式为secretstream头部,随后重复“四字节大端密文长度+密文块”;普通块上限64KiB,最后单独写空的FINAL块。输入、输出均为应用指定的本地路径。
以数据形式体验爵士乐。AI代理流式处理和声分离、色度、音网。误差纳入已测量。
function writeAll($stream,string $data): void {
while ($data!=='') {
$n=fwrite($stream,$data);
if ($n===false || $n===0) throw new RuntimeException('Write failed');
$data=substr($data,$n);
}
}
function readExact($stream,int $size): string {
$data='';
while (strlen($data)<$size) {
$part=fread($stream,$size-strlen($data));
if ($part===false || $part==='') throw new RuntimeException('Truncated file');
$data.=$part;
}
return $data;
}
PHP手册中的sodium_crypto_secretstream_xchacha20poly1305_pull
逐块加密并写入FINAL
function encryptStream($input,$output,string $key): void {
[$state,$header]=sodium_crypto_secretstream_xchacha20poly1305_init_push($key);
writeAll($output,$header);
while (!feof($input)) {
$plain=fread($input,65536);
if ($plain===false) throw new RuntimeException('Read failed');
if ($plain==='') {
if (!feof($input)) throw new RuntimeException('Empty read');
break;
}
$cipher=sodium_crypto_secretstream_xchacha20poly1305_push($state,$plain);
writeAll($output,pack('N',strlen($cipher)).$cipher);
}
$final=sodium_crypto_secretstream_xchacha20poly1305_push(
$state,'','',SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_FINAL);
writeAll($output,pack('N',strlen($final)).$final);
sodium_memzero($state);
}校验每块和结束状态
function decryptStream($input,$output,string $key): void {
$header=readExact($input,SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_HEADERBYTES);
$state=sodium_crypto_secretstream_xchacha20poly1305_init_pull($header,$key);
while (true) {
$length=unpack('Nsize',readExact($input,4))['size'];
$extra=SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_ABYTES;
if ($length<$extra || $length>65536+$extra) throw new RuntimeException('Invalid size');
$decoded=sodium_crypto_secretstream_xchacha20poly1305_pull(
$state,readExact($input,$length));
if ($decoded===false) throw new RuntimeException('Authentication failed');
[$plain,$tag]=$decoded;
if ($tag===SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_FINAL) {
if ($plain!=='' || fread($input,1)!=='' || !feof($input)) {
throw new RuntimeException('Unexpected trailing content');
}
break;
}
if ($tag!==SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_MESSAGE) {
throw new RuntimeException('Unsupported tag');
}
writeAll($output,$plain);
}
sodium_memzero($state);
}用临时文件承接解密结果
调用方先以rb打开密文,使用tempnam在私有目标目录新建临时文件,以wb打开并确认权限0600;在try中调用decryptStream、检查fflush和关闭结果,成功后才原子重命名。异常时关闭句柄并删除临时文件,原目标保持不变。总输入体积和运行时限也应在调用层限制;分块上限不是磁盘配额。分别测试错误密钥、修改块、删去FINAL及追加字节,均不得发布正式明文。


















