PHP 哈希算法在密码存储中的正确用法生产环境落地检查清单
然后第一部分:背景 / 常见问题,先讲痛点:很多生产环境仍存在密码存储不规范的问题,比如用MD5、SHA1等通用哈希算法存储密码,或自行实现加盐逻辑,导致一旦数据泄露,用户密码极易被彩虹表、暴力破解工具攻破,引发批量账号被盗风险。另外部分开发者虽然知道要用慢哈希,但存在参数配置不合理、迁移逻辑不完善等问题,埋下安全隐患。 然后第二部分是落地检查清单,要分点,每个点带[ ],方便对照:生产环境落地检查清单
- [ ] 已完全弃用 MD5、SHA1、CRC32 等通用哈希算法存储密码,禁止使用自定义加盐+通用哈希的组合方案
- [ ] 密码哈希逻辑统一使用 PHP 内置
password_hash()系列函数,禁止自行实现哈希、加盐、比对逻辑 - [ ] 哈希算法优先选择
PASSWORD_DEFAULT(PHP 8.0+ 默认使用 Argon2id,向下兼容 bcrypt),无需手动指定盐值,盐值会自动嵌入哈希结果中 - [ ] 已根据服务器 CPU 性能合理配置哈希成本值(cost),bcrypt 默认 cost=10,Argon2 默认内存/时间/线程参数符合生产环境要求,禁止使用默认成本值不做调整
- [ ] 用户登录验证时统一使用
password_verify()进行哈希比对,禁止自行拆分哈希结果提取盐值再计算比对 - [ ] 已实现哈希自动迁移逻辑:使用
password_needs_rehash()检测当前哈希是否过期(算法升级/成本调整后),用户登录成功后自动重新生成哈希并更新存储 - [ ] 密码哈希结果不会输出到前端接口、日志系统、调试信息中,避免泄露风险
- [ ] 已制定定期评估机制,服务器硬件升级后同步调整哈希成本值,平衡安全性与性能
12]);
if ($hash === false) {
throw new Exception('密码哈希生成失败');
}
$users[$username] = [
'password_hash' => $hash,
'created_at' => time()
];
return true;
}
// 用户登录:验证密码 + 自动迁移旧哈希
function login(string $username, string $password): bool {
global $users;
if (!isset($users[$username])) {
return false;
}
$user = $users[$username];
$hash = $user['password_hash'];
// 第一步:验证密码是否正确
if (!password_verify($password, $hash)) {
return false;
}
// 第二步:检查是否需要重新哈希(比如升级了算法、调整了 cost)
if (password_needs_rehash($hash, PASSWORD_DEFAULT, ['cost' => 12])) {
$newHash = password_hash($password, PASSWORD_DEFAULT, ['cost' => 12]);
$users[$username]['password_hash'] = $newHash;
// 此处执行数据库更新操作如需更完整的 PHP 代码保护与在线加密服务,可访问 https://article.vvxyz.com 了解更多。