ThinkPHP缓存必须加密,推荐sodium_crypto_secretbox()方案:用sodium_crypto_secretbox_keygen()生成32字节密钥,sodium_randombytes_buf(24)生成nonce,密文base64编码存储并附带nonce,解密失败返回false需显式判断,禁用openssl_encrypt和think\facade\Crypt,封装为EncryptedCache装饰器统一处理。

缓存数据不加密,等于把敏感信息摊在内网裸奔——ThinkPHP 本身不提供缓存层加密能力,cache()、Cache::set() 或底层驱动(如 Redis、File、Apcu)写入的都是明文。必须自己加一层封装,且不能图省事用错函数或漏掉关键步骤。
sodium_crypto_secretbox() 是当前最稳妥的选择
ThinkPHP 6+ 运行在 PHP 7.2+ 环境时,sodium_crypto_secretbox() 应作为默认加密方案:它自带认证(AEAD),抗侧信道,无需手动处理填充或 IV 模式,API 简洁且密钥/nonce 生成有标准方式。
-
sodium_crypto_secretbox_keygen()生成 32 字节密钥,不能截断、不能补零、不能用md5()或字符串硬凑 - 每次加密必须调用
sodium_randombytes_buf(24)生成新 nonce(不是 IV),长度固定为 24 字节 - 密文 =
sodium_crypto_secretbox($data, $nonce, $key),返回值是二进制,需 base64 编码后存储 - 解密失败时函数返回
false,不是抛异常,必须显式判断:if ($decrypted === false) { /* 处理篡改或密钥错误 */ } - nonce 必须和密文一起存(比如拼在密文前,或用 JSON 存两个字段),否则无法解密
别在缓存里直接用 openssl_encrypt('AES-256-CBC')
虽然 ThinkPHP 文档提过 openssl_encrypt(),但它在缓存场景下容易踩坑:CBC 模式无认证,密文被篡改后仍能解出乱码;IV 长度依赖算法,填错就失败;且开发者常忘记 base64 编码或混淆 OPENSSL_RAW_DATA 标志位。
- AES-CBC 不验证完整性,攻击者翻转密文某字节,解密后只影响对应位置——但你根本察觉不到
- 若用
AES-256-GCM,虽支持认证,但 PHP 的 GCM 实现对 nonce 重用极度敏感,一旦重复,密钥可能被逆向 - ThinkPHP 自带的
think\facade\Crypt是为 Cookie/配置设计的,不适用于缓存场景,它默认使用弱密钥派生且不暴露 nonce 控制权 - 环境变量里的密钥必须是原始二进制(如
base64_decode(getenv('CACHE_KEY'))),不能直接传 hex 字符串
缓存键和 TTL 同样影响加密有效性
光加密内容不够,如果缓存键可预测或过期时间太长,攻击者仍可能通过枚举键名 + 时间差旁路获取密文,再离线爆破。
立即学习“PHP免费学习笔记(深入)”;
- 避免用用户输入直拼缓存键:
'user_'.$userId.'_token'易被遍历;应哈希后截取:'user_'.substr(md5($userId), 0, 10) - 敏感数据缓存 TTL 必须严格限制,比如 token 类数据设为
900(15 分钟),比 session 过期还短 - 不要复用同一密钥加密不同业务类型的数据(如用户 token 和支付凭证),建议按用途分密钥,并支持双密钥轮换
- 缓存驱动若为文件,确保目录权限为
0700,且不在 Web 可访问路径下(如不放在public/内)
封装成 CacheDecorator 最省心
ThinkPHP 的 CacheInterface 支持装饰器模式,写一个 EncryptedCache 类,把加密逻辑收口,后续所有 Cache::set() 调用自动生效,不用每处都手写加解密。
- 构造函数接收原
CacheInterface实例和密钥(从env('CACHE_ENCRYPTION_KEY')加载) -
set($key, $value, $ttl = null)中先序列化(serialize())、再加密、最后 base64 编码存入 -
get($key, $default = null)中先读取、base64 解码、解密、再unserialize();任一环节失败就返回$default - 注意:加密后体积增大 ~30%,若用 Apcu 或 Redis,需确认 value 大小未超限(如 Redis 默认 512MB,但单 key 建议
真正难的不是选哪个函数,而是密钥怎么加载、nonce 怎么存、失败怎么判、键名怎么防撞——这些细节没对齐,加密就形同虚设。



















