php 8.6用口令保护短文本时,可以先以argon2id派生密钥,再用secretbox进行认证加密,保存随机盐、nonce、密文和固定版本信息。口令不是直接作为加密密钥,解密也不能采信输入文件任意指定的高耗资源参数;下面使用固定、受限的交互级参数。

PHP手册中的sodium_crypto_pwhash
把盐、nonce和密文封装为版本化JSON
<?php
function derive(string $password,string $salt): string {
return sodium_crypto_pwhash(SODIUM_CRYPTO_SECRETBOX_KEYBYTES,$password,$salt,
SODIUM_CRYPTO_PWHASH_OPSLIMIT_INTERACTIVE,
SODIUM_CRYPTO_PWHASH_MEMLIMIT_INTERACTIVE,
SODIUM_CRYPTO_PWHASH_ALG_ARGON2ID13);
}
function protect(string $text,string $password): string {
if (strlen($text)>65536 || $password==='') throw new InvalidArgumentException('输入不符');
$salt=random_bytes(SODIUM_CRYPTO_PWHASH_SALTBYTES);
$nonce=random_bytes(SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);
$key=derive($password,$salt);
try {$cipher=sodium_crypto_secretbox($text,$nonce,$key);}
finally {sodium_memzero($key);}
return json_encode(['v'=>1,'kdf'=>'argon2id13-interactive-v1',
'salt'=>base64_encode($salt),'nonce'=>base64_encode($nonce),
'cipher'=>base64_encode($cipher)],JSON_THROW_ON_ERROR);
}
function unprotect(string $json,string $password): string {
if (strlen($json)>100000) throw new InvalidArgumentException('封装过大');
$e=json_decode($json,true,8,JSON_THROW_ON_ERROR);
if (($e['v']??null)!==1 || ($e['kdf']??null)!=='argon2id13-interactive-v1')
throw new RuntimeException('不支持的参数版本');
$salt=base64_decode($e['salt']??'',true);
$nonce=base64_decode($e['nonce']??'',true);
$cipher=base64_decode($e['cipher']??'',true);
if ($salt===false || strlen($salt)!==SODIUM_CRYPTO_PWHASH_SALTBYTES ||
$nonce===false || strlen($nonce)!==SODIUM_CRYPTO_SECRETBOX_NONCEBYTES ||
$cipher===false || strlen($cipher)<SODIUM_CRYPTO_SECRETBOX_MACBYTES)
throw new RuntimeException('封装格式不符');
$key=derive($password,$salt);
try {$plain=sodium_crypto_secretbox_open($cipher,$nonce,$key);}
finally {sodium_memzero($key);}
if ($plain===false) throw new RuntimeException('口令错误或数据已损坏');
return $plain;
}
PHP手册中的sodium_crypto_secretbox
固定参数版本,避免输入触发无限制开销
此版本把KDF参数固定为已知方案,不从JSON读取任意内存和运算限制。部署时确认交互级参数符合机器预算,并限制并发解密次数;未来改变方案需增加版本并保留旧版解密逻辑。salt和nonce无需保密,但每次加密都应重新随机生成,不能复用同一个nonce与密钥组合。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
认证失败和口令管理分别处理
解密失败统一提示口令错误或损坏,不返回未经认证的明文。口令不要写在源代码、日志或封装文件里;该方法用于普通短文本,不是登录密码存储方案。sodium_memzero只清理所持有的变量,不能承诺所有运行时副本都被擦除;敏感应用还要评估交换空间、备份和进程访问权限。


















