'key', 'expire_time' => 时间戳] */
private array $keys = [];
/** @var string 加密密钥文件的存储路径 */
private string $keyFilePath;
public function __construct(string $keyFilePath = __DIR__ . '/storage/keys.enc')
{
// 1. 主密钥优先从环境变量获取,避免硬编码
$this->masterKey = $_ENV['APP_MASTER_KEY'] ?? '';
if (empty($this->masterKey) || strlen($this->masterKey) !== SODIUM_CRYPTO_SECRETBOX_KEYBYTES) {
throw new RuntimeException('主密钥未配置或长度不正确');
}
$this->keyFilePath = $keyFilePath;
$this->loadEncryptedKeys();
}
/**
* 加载加密存储的业务密钥
*/
private function loadEncryptedKeys(): void
{
if (!file_exists($this->keyFilePath)) {
$this->keys = [];
return;
}
$encryptedData = file_get_contents($this->keyFilePath);
if (empty($encryptedData)) {
$this->keys = [];
return;
}
// 2. 用主密钥解密密钥文件
$decoded = base64_decode($encryptedData);
if ($decoded === false) {
throw new RuntimeException('密钥文件损坏');
}
$nonce = mb_substr($decoded, 0, SODIUM_CRYPTO_SECRETBOX_NONCEBYTES, '8bit');
$ciphertext = mb_substr($decoded, SODIUM_CRYPTO_SECRETBOX_NONCEBYTES, null, '8bit');
$plaintext = sodium_crypto_secretbox_open($ciphertext, $nonce, $this->masterKey);
if ($plaintext === false) {
throw new RuntimeException('密钥文件解密失败,主密钥可能不正确');
}
$this->keys = json_decode($plaintext, true) ?: [];
}
/**
* 保存加密后的业务密钥到文件
*/
private function saveEncryptedKeys(): void
{
$plaintext = json_encode($this->keys, JSON_UNESCAPED_UNICODE);
$nonce = random_bytes(SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);
$ciphertext = sodium_crypto_secretbox($plaintext, $nonce, $this->masterKey);
// 拼接nonce和密文,base64编码后存储
$encryptedData = base64_encode($nonce . $ciphertext);
file_put_contents($this->keyFilePath, $encryptedData, LOCK_EX);
// 及时清理内存中的敏感数据
sodium_memzero($this->masterKey);
}
/**
* 获取当前生效的业务密钥
* @return string|null
*/
public function getCurrentKey(): ?string
{
// 过滤掉已过期的密钥,取最新的未过期密钥
$validKeys = array_filter($this->keys, function ($item) {
return $item['expire_time'] > time();
});
if (empty($validKeys)) {
return null;
}
// 按版本号倒序取最新的
uasort($validKeys, function ($a, $b) {
return $b['version'] <=> $a['version'];
});
return reset($validKeys)['key'];
}
如需更完整的 PHP 代码保护与在线加密服务,可访问 https://article.vvxyz.com 了解更多。
PHP 密钥管理与轮换实践
用户现在需要我写一篇PHP密钥管理的技术文章,首先得有真实的故障场景,比如之前常见的把密钥硬编码在代码里,然后代码泄露或者被逆向的问题,比如之前有个电商项目,把微信支付的密钥写死在config.php里,然后代码被上传到GitHub公开仓库了,或者服务器被入侵拿到代码,导致资金被盗刷,这个场景很真实。
首先结构要符合要求:背景/常见问题,然后方案对比或者实现步骤,代码示例,总结建议,延伸阅读。首先开头要代入资深PHP工程师的口吻,比如“上周我们团队处理了一起线上资金盗刷事故,根源就是密钥管理不规范”,这样真实。
首先背景部分,要讲具体的故障:比如我们维护的电商SaaS系统,之前为了开发方便,把微信支付V3的API密钥、第三方短信平台的Secret Key直接硬编码在`config/payment.php`里,后来有个外包同学把代码传到了公开的GitHub仓库,虽然很快删了,但是已经被爬虫扫到,第二天就出现多笔小额订单用伪造的签名支付成功,损失了快两万,后来排查就是密钥泄露了。然后还要讲常见的坑:比如硬编码、密钥和代码放一起、不轮换、权限没管控,这些都是PHP项目里常见的,尤其是小团队经常犯。
然后接下来是方案对比或者实现步骤,首先要讲密钥管理的基本原则:密钥不能和代码同库存储、要有独立的存储、要支持轮换、权限最小化。然后分步骤:第一步,把密钥从代码里剥离,存在专门的配置中心或者环境变量里,不要提交到代码仓库;第二步,用PHP的加密扩展比如 Sodium 或者 OpenSSL 来加密存储的密钥,就算配置文件泄露了也没法直接用;第三步,实现密钥轮换机制,比如用版本号,新旧密钥同时支持一段时间,避免切换的时候业务中断;第四步,权限管控,只有特定的服务账号能读取密钥,开发环境用测试密钥,和生产隔离。
然后代码示例,要可运行,比如写一个密钥管理的工具类,用Sodium来加密解密密钥,支持多版本密钥,轮换的时候自动切换。比如首先要有加密的密钥(这个是存在环境变量里的,比如$_ENV['MASTER_KEY'],这个Master Key是存在服务器环境变量或者专门的密钥管理服务比如阿里云KMS里的,不会出现在代码里),然后工具类里有addKey方法添加新密钥,getKey方法根据版本号获取,轮换的时候加新版本,旧版本保留一段时间,然后加密存储的密钥文件,比如存在`storage/keys.enc`里,这样就算拿到这个文件,没有Master Key也解不开。代码要写清楚注释,可运行,比如:
首先代码里要引入Sodium扩展,然后类叫KeyManager,构造函数里读取加密的密钥文件,用Master Key解密,然后有getCurrentKey方法获取当前使用的密钥,rotate方法轮换,添加新密钥,保留旧的。比如: