PHP 数据加密最佳实践

```html PHP 数据加密最佳实践

PHP 数据加密最佳实践

在 Web 应用中,安全地处理敏感数据(如用户密码、API 密钥、个人身份信息)是开发者的首要责任。PHP 提供了成熟、安全的加密工具,但错误使用仍可能导致严重漏洞。

✅ 优先使用 password_hash()password_verify()

对密码进行哈希时,永远不要使用 md5()、sha1() 或 crypt()(无盐)。应使用 PHP 内置的现代密码哈希函数:

// ✅ 正确:使用 bcrypt(默认算法),自动加盐、自适应成本
$hash = password_hash('user_password_123', PASSWORD_DEFAULT);
// 输出类似:$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi

// 验证时只需:
if (password_verify($inputPassword, $hash)) {
    echo "登录成功";
}

PASSWORD_DEFAULT 会随 PHP 升级自动采用更强算法(如将来支持 Argon2),确保长期安全性。

✅ 敏感数据加密:使用 sodium_crypto_secretbox()

对于需加密存储(如数据库中的 API token、身份证号),推荐使用 libsodium —— PHP 7.2+ 内置、经严格审计的现代加密库:

// 生成密钥(仅一次!安全保存于环境变量或密钥管理服务)
$key = sodium_crypto_secretbox_keygen();

// 加密
$message = 'secret_api_key_xxx';
$nonce = random_bytes(SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);
$ciphertext = sodium_crypto_secretbox($message, $nonce, $key);

// 存储 $nonce . $ciphertext(nonce 可公开,但必须唯一)
$encrypted = base64_encode($nonce . $ciphertext);

// 解密
$decoded = base64_decode($encrypted);
$nonce = mb_substr($decoded, 0, SODIUM_CRYPTO_SECRETBOX_NONCEBYTES, '8bit');
$ciphertext = mb_substr($decoded, SODIUM_CRYPTO_SECRETBOX_NONCEBYTES, null, '8bit');
$original = sodium_crypto_secretbox_open($ciphertext, $nonce, $key);

if ($original === false) throw new Exception('解密失败:密钥错误或数据被篡改');
⚠️ 重要提醒:密钥 绝不可硬编码!应通过 getenv('ENCRYPTION_KEY') 从环境变量加载,并使用 .env 文件(确保不提交至 Git)。同时启用 sodium_init() 显式初始化。

❌ 避免的反模式

  • 手动实现 AES/CBC(易出错,缺少认证)
  • 重复使用同一 nonce 或 IV
  • 将加密密钥与密文一同存储在数据库
  • mcrypt(已废弃且不安全)

总结:安全不是功能,而是贯穿设计、实现与运维的持续实践。选择经过验证的工具,遵循最小权限原则,并定期审计加密策略——这才是 PHP 应用真正的“金盾”。

```