ThinkPHP数据库连接凭证必须运行时解密、密钥隔离且失败即报错；需在config/database.php中手动调用解密函数，如'password' => \app\common\Security::decrypt(getenv('DB_PASSWORD_CIPHER'))，密钥须由KMS等外部服务管理，严禁明文存储或硬编码。
数据库连接信息不能靠“.env 加密”或 “database.php 里写个注释”来保护——它必须是运行时解密、密钥隔离、失败即报错的闭环。ThinkPHP 本身不提供凭据自动解密能力，所有“加密存储”本质都是你手动在 config/database.php 里调用解密函数，把密文转成明文塞进配置数组。
database.php 里怎么写解密逻辑才真正生效
ThinkPHP 的数据库配置是纯 PHP 数组，支持任意表达式。只要最终返回字符串，就能用。推荐直接在 config/database.php 中调用自定义解密函数，而不是改框架源码或 Hook 初始化流程。
-
'password' => \app\common\Security::decrypt(getenv('DB_PASSWORD_CIPHER'))—— 注意：必须是系统级环境变量（如putenv()注入），不是从.env文件读出来的值；否则等于把密文又存回不安全的地方 - 解密函数必须在连接建立前就可用，所以类要能被自动加载（命名空间正确、文件路径符合 PSR-4）
- 解密失败时必须
throw new \Exception('DB credential decrypt failed')，否则连接会静默失败，日志里只显示“connection refused”，根本查不到原因 - 别在
database.php里写file_get_contents直接读密钥文件——权限、路径、编码都容易出错；应统一由解密类管理密钥获取逻辑
为什么不能用 think-crypt 或 config('app.aes_key') 做数据库密码解密
ThinkPHP 自带的 think-crypt 扩展默认使用 md5(config_key) 派生密钥、IV 固定，不符合现代加密实践；更关键的是：它的初始化发生在数据库连接之后，database.php 加载时该扩展还没 ready，强行 require 会导致循环依赖或 Fatal error。
-
config('app.aes_key')是运行时才读取的配置，而database.php在应用启动极早期就被include，此时 Config 组件尚未初始化，调用会返回null - 如果硬要用，必须把密钥放在
getenv()可读的环境变量里，比如AES_KEY_BASE64，再在解密函数里base64_decode(getenv('AES_KEY_BASE64')) - IV 必须每次加密随机生成，且和密文一起存储（例如
base64_encode($iv . $ciphertext)），绝不能复用或硬编码
密钥管理最容易踩的三个坑
加密没用，往往不是算法弱，而是密钥管得太随意。生产环境一旦密钥泄露，整个加密形同虚设。
立即学习“PHP免费学习笔记（深入）”；
- 密钥绝不能写进代码、
.env、Git 提交历史，哪怕你base64或str_rot13了也等于没加密 - 不能用时间戳、项目名、固定字符串（如
'my_project_key_2026'）做密钥——它们可预测，攻击者连爆破都不用 - 生产环境必须用外部密钥服务：阿里云 KMS、AWS Secrets Manager、HashiCorp Vault；开发环境可用本地文件，但该文件必须
chmod 600且加进.gitignore，绝对不进版本库
SSL 加密和凭据加密是两回事，别混在一起
有人以为开了 MySQL SSL 就不用加密数据库密码，这是典型误解。SSL 只加密传输过程，不保护配置文件里的明文凭据；而凭据加密解决的是“代码泄露后数据库是否裸奔”的问题。两者必须同时做，且独立配置。
- SSL 配置必须写在
params数组里，用PDO::MYSQL_ATTR_SSL_CA等常量，路径必须是绝对路径，比如/etc/mysql/ssl/ca.pem - SSL 的
PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => true和凭据解密无关，但它会影响连接是否校验证书——漏配这个，即使 CA 路径全对，证书校验也不会触发 - 如果你用了 Swoole 或 Workerman 长连接，凭据一旦解密就长期驻留内存，记得连接建立后立刻
unset($config['password'])，避免被 xdebug 或日志 dump 出来
最常被忽略的其实是解密函数本身的健壮性：它得处理空值、base64 解码失败、openssl 扩展未启用、密钥长度不符（AES-256 要 32 字节）等各种边界情况——这些地方不加 guard，线上一报错就是数据库连不上，而不是“密码错了”。
