必须显式标记密钥版本并动态加载——加密时加前缀或json封装，解密时解析版本号并从配置中心读取对应密钥和iv；验签需遍历多密钥fallback；iv须与密文同存且不可复用；密钥须加密存储于安全源。
旧密文解不开，不是密钥写错了，而是没做版本路由——PHP 本身不识别“v1密钥加密的字符串该用v1解”，必须自己加一层判断逻辑。
openssl_encrypt / openssl_decrypt 必须带密钥版本标识
这两个函数只认密钥内容和 IV，完全不关心你心里想的是哪一版。不显式标记版本，就等于把所有历史密文都判了“死刑”。
- 加密时，别直接
openssl_encrypt($data, 'AES-256-CBC', $key, ...)，得先拼前缀：'v2'.openssl_encrypt(...)或用 JSON 封装：json_encode(['v' => 'v2', 'c' => $ciphertext, 'iv' => base64_encode($iv)]) - 解密时，必须先解析前缀或字段：
substr($encrypted, 0, 2) === 'v1'再取$keys['v1']和对应 IV；IV 不能复用，必须从密文中原样取出 - 版本号不能硬写死在 if 分支里，得从配置中心或数据库读，比如
config('encryption.active_keys')返回['v1', 'v2']数组
ThinkPHP 验签场景下多密钥并行校验怎么写
签名密钥轮换最怕老请求 401，因为客户端还没升级。ThinkPHP 没内置多密钥 fallback，得手动遍历尝试。
- 验签入口函数里，别只用
$config['sign_key']，要循环$config['sign_keys']（格式如['v1' => 'xxx', 'v2' => 'yyy']） - 按顺序试：先用
v2算 HMAC-SHA256，失败再试v1；任一通过即放行，避免中断业务 - 旧密钥至少保留 24 小时，期间记录
sign_key_used: v1埋点，等监控显示 v1 调用量归零再下线 - 注意 timestamp + nonce 校验必须在密钥验证之前完成，否则重放攻击可绕过版本切换逻辑
密钥存储和加载不能走 config.php 硬编码
把 $keys = ['v1' => 'abc', 'v2' => 'def'] 写进 PHP 配置文件，等于把密钥轮换变成发版重启——这根本不是轮换，是事故演练。
- 密钥必须从外部安全源加载：环境变量（
getenv('ENCRYPTION_KEY_V1')）、KMS 接口、或权限受限的配置中心（如 Consul KV + ACL） - 每次加解密都要实时拉取最新密钥列表，而不是启动时缓存一份；否则新密钥上线后，长连接服务可能永远不知道
- 密钥本身需加密存储：用 RSA 公钥加密 AES 密钥后再落库，私钥仅存于可信节点本地
- 别用
file_get_contents('/path/to/key')直接读明文文件——文件权限、Git 提交、日志打印都可能泄露
最易被忽略的一点：IV 不是密钥的附属品，它是加密操作的必需输入项，且必须与密文同生命周期存储。很多人轮换了密钥却忘了旧 IV 已随密文入库，结果解密时传了个新生成的 IV，必然失败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
