怎样用PHP的password_hash函数安全地存储用户密码

wen PHP项目 2026-06-05 45

如何用PHP的password_hash函数安全地存储用户密码？完整指南与最佳实践

目录导读

为什么密码安全存储如此重要？
PHP password_hash函数的核心原理
password_hash与password_verify的实战用法
密码算法的选择与成本因子优化
常见错误与安全陷阱规避
用户密码安全的其他最佳实践
问答环节：解决高频疑问

为什么密码安全存储如此重要？

在Web开发中，用户密码是最敏感的数据之一，如果密码以明文或弱哈希形式存储，一旦数据库泄露（如SQL注入、服务器漏洞等），攻击者可以直接获取用户凭证，导致账户被盗、数据泄露甚至金融损失，据统计,2023年全球因密码泄露造成的损失超过数十亿美元。

关键点：即使你认为自己的系统很安全，也必须假定数据库随时可能被攻破，密码必须以“不可逆”且“抗暴力破解”的形式存储。

PHP password_hash函数的核心原理

PHP从5.5.0版本开始内置了password_hash()函数，专门用于安全密码哈希,其核心原理是：

自动加盐：每个密码会随机生成一个独特的“盐值”（salt），并混入哈希计算，即使两个用户使用相同密码,产生的哈希值也完全不同。
自适应算法：支持PASSWORD_BCRYPT、PASSWORD_ARGON2I、PASSWORD_ARGON2ID等算法，可抵抗GPU/ASIC硬件加速破解。
成本因子（Cost）：允许调整哈希计算强度（如bcrypt的cost参数）,增加暴力破解的时间成本。

对比老旧的md5()和sha1()：这些函数速度快、无盐值，且已被彩虹表完全破解,绝不可用于密码存储。

password_hash与password_verify的实战用法

1 注册时生成哈希

// 用户注册时接收密码
$password = $_POST['password'];
// 使用password_hash生成安全哈希（默认算法：bcrypt）
$hashedPassword = password_hash($password, PASSWORD_DEFAULT);
// 将$hashedPassword存入数据库（建议字段类型：VARCHAR(255)）

2 登录时验证密码

// 从数据库查询用户，假设得到$storedHash
$storedHash = $user['password_hash'];
// 使用password_verify验证输入密码
if (password_verify($_POST['password'], $storedHash)) {
    // 登录成功
} else {
    // 密码错误
}

注意：password_hash每次生成的结果都不同（因为盐值随机），但password_verify可以正确验证,无需手动处理盐值。

密码算法的选择与成本因子优化

1 推荐算法优先级

PASSWORD_ARGON2ID（PHP 7.3+支持）：内存硬算法,抗GPU破解极强。
PASSWORD_ARGON2I（PHP 7.2+支持）：类似上者,但存在时序攻击风险较低。
PASSWORD_BCRYPT（PHP 5.5+支持）：广泛兼容，稳定可靠,默认选项。
绝不要用：PASSWORD_DEFAULT在将来版本可能改变，建议显式指定算法（如PASSWORD_ARGON2I）。

2 成本因子的设置

// bcrypt的cost建议设为12（较新服务器可尝试13）
$options = ['cost' => 12];
$hash = password_hash($password, PASSWORD_BCRYPT, $options);
// Argon2的内存消耗、时间消耗、并行度
$options = [
    'memory_cost' => 1<<17, // 128MB
    'time_cost'   => 4,       // 迭代次数
    'threads'     => 2        // 并行线程数
];
$hash = password_hash($password, PASSWORD_ARGON2ID, $options);

成本因子测试方法：在开发环境中测试哈希生成时间，控制在0.25-0.5秒之间（过慢影响用户体验，过快不安全）,生产环境应使用相同因子。

常见错误与安全陷阱规避

1 错误一：手动拼接盐值

// ❌ 错误：手动生成盐值并拼接，极易出错且不兼容future版本
$salt = bin2hex(random_bytes(16));
$hash = md5($salt . $password); // 危险！
// ✅ 正确：完全依赖password_hash内置盐值
$hash = password_hash($password, PASSWORD_BCRYPT);

2 错误二：使用过时的算法（如MD5、SHA1）

即使加盐的MD5，在现代GPU下也能被快速破解（每秒数十亿次）。所有哈希算法必须有自适应成本因子。

3 错误三：未更新旧哈希

如果系统从MD5迁移到password_hash,应允许用户登录时自动升级：

if (password_verify($input, $storedHash)) {
    // 检查是否需要升级（例如使用更安全的算法）
    if (password_needs_rehash($storedHash, PASSWORD_BCRYPT, ['cost' => 12])) {
        $newHash = password_hash($input, PASSWORD_BCRYPT, ['cost' => 12]);
        // 更新数据库中的哈希
    }
    // 登录成功
}

4 错误四：存储哈希字段长度不足

Bcrypt哈希最多60字符，但Argon2可能更长。必须使用VARCHAR(255)或TEXT类型,避免截断。

用户密码安全的其他最佳实践

强制HTTPS：防止密码在传输中被中间人窃取。
密码强度策略：建议至少8位，包含大小写字母+数字+特殊字符（但不要过度限制，可参考NIST最新指南）。
不要限制密码长度上限（如不超过20位）,因为合法哈希时长度不是问题。
使用密码管理器友好的验证：允许粘贴长密码。
存储密码历史：避免用户使用近3-5次用过的密码（使用password_verify对比历史哈希）。
速率限制：对登录尝试进行限速（如5次错误后等待15分钟）,防止暴力破解。

问答环节：解决高频疑问

Q1：password_hash生成的哈希能解密吗？ A：不能，password_hash是单向哈希，不可逆，验证时通过password_verify将输入密码与哈希中的盐值和算法重新计算比对,而非解密。

Q2：我应该使用PASSWORD_DEFAULT还是指定算法？ A：明确指定算法（如PASSWORD_ARGON2I）。PASSWORD_DEFAULT可能随PHP版本变化而改变，导致旧哈希失效（尽管password_needs_rehash可以处理，但增加复杂性）。

Q3：如果数据库泄露，bcrypt哈希能确保安全吗？ A：不能100%确保，但能极大延缓破解速度，如果使用cost=12的bcrypt，单个密码暴力破解可能需要数年（取决于GPU算力），但仍建议配合其他安全措施：及时通知用户修改密码、检测异常登录。

Q4：为什么我的password_hash生成时间很长？ A：这是正常的！成本因子原理就是故意增加计算耗时，如果时间超过1秒，可适当降低cost（但不要低于10），同时检查服务器是否开启硬件加速（如Argon2专用指令集）。

Q5：password_hash能用于加密其他数据吗？ A：不能，password_hash专为密码设计，不适用于对称加密或数据保护，其他数据应使用openssl_encrypt等函数。

用PHP的password_hash函数存储密码，是目前最简单且安全的方案，只需遵循：使用推荐的算法（Argon2或Bcrypt）、设置合理的成本因子、确保字段长度足够、定期更新旧哈希，切勿自作聪明地手动加盐或使用旧式哈希，安全无小事,从正确存储密码开始保护你的用户。