PHP怎么处理Paragonie安全库_PHP加密与随机数生成【技巧】-php教程-PHP中文网

必须用paragonie的crypto_aead等封装函数而非仅random_bytes()，因其自动处理nonce生成、验证等易错环节；密钥须用sodium_crypto_pwhash派生或random_bytes(32)生成；解密失败静默返回false，需手动检查并双重判断。

php怎么处理paragonie安全库_php加密与随机数生成【技巧】

为什么不能直接用 `random_bytes()` 就完事？

PHP 7.0+ 确实自带 random_bytes()，但它只是“安全随机字节生成器”，不等于“加密功能封装”。Paragonie 的 cryptoaead、cryptosecretbox 等函数才是开箱即用的 AEAD 加密原语——它们自动处理 nonce 生成、验证、填充、密钥派生等易出错环节。

常见错误现象：hash_hmac() + openssl_encrypt() 手动拼凑，结果 nonce 重用、验证缺失、密文被篡改后仍解密成功。

使用场景：需要端到端保密性 + 完整性（比如用户敏感配置、API token payload、数据库字段加密）。

必须用 ParagonIE_SodiumCompat 或原生 sodium*()，别自己实现 HKDF 或 CBC 模式
random_bytes(24) 生成的 nonce 不能复用，每次加密必须新取
如果用 crypto_secretbox()，解密失败时返回 false，不是抛异常，得手动检查

use ParagonIE\Sodium\Core\Compat;
$nonce = random_bytes(SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);
$ciphertext = sodium_crypto_secretbox($message, $nonce, $key);

`sodium_crypto_aead_xchacha20poly1305_ietf_encrypt()` 怎么选参数？

这是目前最推荐的 AEAD 函数，比 crypto_secretbox() 更安全（XChaCha20 抗侧信道，Poly1305 验证强），且支持附加数据（AD）——比如你不想加密但要绑定验证的请求 ID、时间戳。

参数差异：

第 1 个参数是明文（$message），必须是 string，不能是 null 或数组
第 2 个参数是附加数据（$ad），可为 null 或空字符串；若传入，解密时必须提供完全相同的值，否则验证失败
第 3 个参数是 nonce，长度必须严格为 SODIUM_CRYPTO_AEAD_XCHACHA20POLY1305_IETF_NPUBBYTES（24 字节）
第 4 个参数是密钥，长度必须为 SODIUM_CRYPTO_AEAD_XCHACHA20POLY1305_IETF_KEYBYTES（32 字节）

性能影响：比 AES-GCM 在 PHP 中略慢，但差距可忽略；兼容性上，ParagonIE_Sodium_Compat 能 fallback 到纯 PHP 实现，无需扩展启用。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

密钥从哪来？别用 `md5('password')` 或 `openssl_random_pseudo_bytes()`

密钥不是密码。它必须是密码学安全的、固定长度的随机字节，且永远不暴露、不推导、不复用。

常见错误现象：用用户密码直接当密钥、用时间戳拼接后 hash、把密钥硬编码在 config.php 里。

密钥应由 random_bytes(32) 生成，存于环境变量或密钥管理服务（如 HashiCorp Vault）
若需从密码派生密钥，必须用 sodium_crypto_pwhash()（不是 password_hash()），指定 opslimit/memorylimit
不要用 openssl_random_pseudo_bytes()：它已废弃，且在某些系统上 fallback 不安全

$key = sodium_crypto_pwhash(
    SODIUM_CRYPTO_AEAD_XCHACHA20POLY1305_IETF_KEYBYTES,
    $password,
    $salt,
    SODIUM_CRYPTO_PWHASH_OPSLIMIT_INTERACTIVE,
    SODIUM_CRYPTO_PWHASH_MEMLIMIT_INTERACTIVE
);