php 8.6使用openssl的aes-256-gcm保护应用配置时,需要32字节密钥、每次新生成的iv以及完整认证标签。解密端应先校验封包字段和标签长度,并将false视为认证失败,不能继续解析结果。密文与密钥应分开保管,应用启动时再加载验证后的配置。

PHP手册中的openssl_encrypt定义
密钥与加密结果分开保存
密钥通过环境变量注入,示例要求其为32字节随机密钥的Base64表示。openssl_encrypt的passphrase参数不会自动执行密码派生,不能直接把短口令当成AES密钥。
<?php $encodedKey = getenv('CONFIG_KEY_B64');
$key = is_string($encodedKey) ? base64_decode($encodedKey, true) : false;
if ($key === false || strlen($key) !== 32) throw new RuntimeException('配置密钥长度无效');
$iv = random_bytes(12);
$tag = '';
$aad = 'myapp.config.v1';
$plain = '{"feature_enabled":true}';
$ciphertext = openssl_encrypt($plain, 'aes-256-gcm', $key,
OPENSSL_RAW_DATA, $iv, $tag, $aad, 16);
if ($ciphertext === false || strlen($tag) !== 16) throw new RuntimeException('加密失败');
$package = json_encode(['v' => 1, 'iv' => base64_encode($iv),
'tag' => base64_encode($tag), 'data' => base64_encode($ciphertext)], JSON_THROW_ON_ERROR);
echo $package, PHP_EOL;

PHP手册中的openssl_decrypt定义
解密前检查标签和所有编码字段
下面接在同一示例中使用package变量;从文件加载时先限制文件体积,再按同样规则验证。AAD是应用约定,不保密,但加解密两端必须一致。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
$data = json_decode($package, true, 16, JSON_THROW_ON_ERROR);
if (($data['v'] ?? null) !== 1) throw new RuntimeException('不支持的封包版本');
foreach (['iv', 'tag', 'data'] as $field) {
if (!isset($data[$field]) || !is_string($data[$field])) {
throw new RuntimeException('封包字段缺失');
}
$data[$field] = base64_decode($data[$field], true);
if ($data[$field] === false) throw new RuntimeException('Base64无效');
}
if (strlen($data['iv']) !== 12 || strlen($data['tag']) !== 16) {
throw new RuntimeException('IV或认证标签长度错误');
}
$decoded = openssl_decrypt($data['data'], 'aes-256-gcm', $key,
OPENSSL_RAW_DATA, $data['iv'], $data['tag'], $aad);
if ($decoded === false) throw new RuntimeException('配置认证失败');
$config = json_decode($decoded, true, 16, JSON_THROW_ON_ERROR);
固定封包约定并安排密钥生命周期
PHP手册特别提醒,解密函数不会替调用方检查标签长度;接受截短标签会削弱校验,必须像示例一样先检查。不要在同一密钥下重复使用IV;密钥轮换时可增加受控key_id并使用白名单选择密钥,旧配置迁移完成前保留必要的旧密钥读取能力。加密不代替运行账号权限和配置备份。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










