PHP 怎么存储密钥

wen PHP项目 2026-08-10 4

PHP 密钥存储终极指南：从环境变量到 KMS 的全面实践

目录导读

为什么你不能把密钥硬编码在 PHP 代码里？ （安全风险与合规性）
基础方案：环境变量与 .env 文件（12-Factor 原则）
进阶方案：配置文件外置与文件权限陷阱
企业级方案：密钥管理系统（KMS）与云厂商集成
PHP 扩展与工具：Vault、OpenSSL 与 Sodium 的实战用法
常见问答 Q&A：密钥轮换、代码泄露与性能开销

正文开始

为什么你不能把密钥硬编码在 PHP 代码里？

想象一下：你的 GitHub 仓库是公共的，或者你的同事把 config.php 误传到了 npm 上，一旦密钥（如 API Key、数据库密码、JWT 签名密钥）随代码泄露，攻击者就能直接操作你的数据库或模拟你的身份。安全合规（如 PCI-DSS、GDPR） 也强制要求密钥不能以明文存在于代码库中，硬编码的另一个问题是难以轮换——每次改密钥都要重新部署代码。

PHP 怎么存储密钥

基础方案：环境变量与 .env 文件（12-Factor 原则）

这是最主流、最推荐的做法。 按照 12-Factor 应用原则，配置（包括密钥）应从代码中剥离,存储于环境中。

实操：在项目根目录创建 .env 文件（确保加入 .gitignore如：
```
DB_PASSWORD=super_secret_123
JWT_SIGNING_KEY=abc123xyz
```
在 PHP 中读取：不要用 parse_ini_file() 直接解析，因为 $_ENV 可能未开启，推荐使用 vlucas/phpdotenv 库（Laravel 默认方案）或直接用 getenv() 函数。
```
$dbPass = getenv('DB_PASSWORD'); // 或 $_ENV['DB_PASSWORD']
```
服务器配置：在 Nginx/Apache 的 vhost 或 systemd 服务文件中，通过 env 参数注入,避免依赖文件系统。

为什么不用常量 define()？ 因为 define() 是全局的，在框架初始化时就被加载,不利于延迟加载和测试隔离。

进阶方案：配置文件外置与文件权限陷阱

如果你无法使用环境变量（例如传统虚拟主机），可把密钥放在 Web 根目录之外的 config/keys.php 文件里。

<?php return ['db_pass' => 'xxx'];

然后通过 require_once 引入。关键陷阱：

必须设置文件权限为 600（仅所有者可读写），防止其他 PHP 用户或进程读取。
禁用 PHP 的 display_errors,避免错误信息中泄露文件路径。
在 Nginx 中务必禁止对外访问该目录（deny all）。

企业级方案：密钥管理系统（KMS）与云厂商集成

当你有几十台服务器，或者密钥需要实时轮换时，文件系统方案就失效了，此时必须使用 KMS。

云厂商 KMS：阿里云 KMS、AWS KMS、Google Cloud KMS，它们提供硬件加密密钥，你的应用只持有“密文信封”,解密由云服务完成。

PHP 集成示例（以 AWS KMS 为例，通过 SDK）：

use Aws\Kms\KmsClient;
$kms = new KmsClient(['region' => 'us-east-1', 'version' => 'latest']);
$result = $kms->decrypt(['CiphertextBlob' => base64_decode($encryptedKey)]);
$plaintextKey = $result['Plaintext']; // 内存中获取明文

Hashicorp Vault：开源方案，提供动态密钥和租约，PHP 客户端库 vault-php 可安全读取。

关键优势：密钥永驻内存，审计日志完善，且支持密钥版本化（自动轮换）。

PHP 扩展与工具：OpenSSL 与 Sodium 的实战用法

有时候你需要生成密钥（如 RSA 私钥）或做本机加密存储。

OpenSSL 扩展：生成密钥对，但不要将私钥直接存数据库，应存储在安全目录，并用 openssl_encrypt 再加一层口令保护。

$keyPair = openssl_pkey_new(['private_key_bits' => 2048]);
openssl_pkey_export($keyPair, $privateKey, 'your-passphrase');
file_put_contents('/path/private.pem', $privateKey); // 权限 600

Sodium 扩展（PHP 7.2+ 内置）：用于对称加密，推荐将 SODIUM_CRYPTO_SECRETBOX_KEY 存于环境变量。
```
$key = sodium_hex2bin(getenv('APP_KEY'));
$encrypted = sodium_crypto_secretbox($data, $nonce, $key);
```
密钥轮换脚本：写一个 CLI 脚本（非 Web 访问），定期更新环境变量或 KMS 中的版本。

常见问答 Q&A

Q1：把密钥放在 .env 文件里，如果服务器被入侵，文件被读取怎么办？ A：这是最后一道防线，前提是你已做了纵深防御——文件权限 600、Web 目录隔离、PHP 禁用危险函数。.env 仅存在于服务器上，不进入代码仓库，若担心，可使用 KMS 加密 .env 本身（密钥在云上）。

Q2：为什么用 getenv() 而不是 $_ENV？ A：在 PHP-FPM 模式下，$_ENV 可能为空，因为 variables_order 配置项默认不含 E，而 getenv() 直接读取系统环境变量，不受此限制，推荐用 $_SERVER 或 getenv()。

Q3：如何在命令行（CLI）中安全使用密钥？ A：不要用 env 变量明文传给命令（会出现在 ps 进程列表中），改为让 CLI 脚本从受保护的文件或 KMS 读取，php artisan crypto:decrypt --key=file:///etc/app.key。

Q4：性能会影响吗？每次请求都读取 KMS 会不会慢？ A：会，解决方案是本地缓存：首次从 KMS 解密后，把明文密钥缓存在内存（如 APCu）或 /dev/shm 下的临时文件中，设置短过期时间（如 5 分钟）,并配合缓存失效机制。

Q5：密钥泄露后，紧急响应步骤是什么？ A：1）立即在 KMS 或配置中心禁用/轮换该密钥；2）回溯 Git 历史，强制所有开发者撤销个人访问令牌；3）检查服务器日志和数据库访问记录，确认是否被滥用；4）修改所有使用该密钥的系统密码。

存储密钥不是“一行代码”的问题，而是 架构信任边界 的体现，从单机 .env 到分布式 KMS，核心原则不变：最小化暴露面、动态轮换、审计可追踪，建议根据团队规模和业务风险，从方案 2 或 3 起步，逐步向 KMS 迁移。没有绝对安全的存储，只有更慢的被破解速度。