PHP 密码哈希:Argon2id、bcrypt 与安全迁移
学习如何使用 Argon2id 和 bcrypt 在 PHP 中安全地实现密码哈希,选择合适参数,验证用户凭证,并在不强制用户重置密码的情况下迁移旧密码哈希。
密码存储是 Web 应用程序中最重要的安全决策之一。数据库泄露不应立即暴露用户的凭据,但弱密码哈希可能使被盗哈希的攻击成本很低。
PHP 内置了哈希、验证和升级密码的函数。挑战在于选择正确的算法、针对基础架构进行配置,以及在不中断身份验证的情况下迁移现有账户。
对于新应用程序,当 PHP 构建支持 Argon2id 时,通常首选 Argon2id。bcrypt 仍然是一个实用的兼容选项。 两者都应通过 PHP 的密码 API 使用,而不是通过自制加密。
本指南涵盖实现、参数选择、遗留迁移和常见错误。
为什么 SHA-256 不适合密码存储
SHA-256 被设计得很快。这使其适用于完整性检查,但本身不适合密码存储:拥有被盗哈希的攻击者可以快速测试许多密码猜测。
专用密码哈希算法有意消耗更多资源。Argon2id 可能需要大量内存以及处理时间,使大规模猜测更加昂贵。
安全的存储系统需要唯一的随机盐、可配置的工作因子以及随着硬件改进而增加工作因子的方法。PHP 的 password_hash() 会自动生成并存储所需的盐信息。
OWASP 密码存储速查表 建议使用自适应密码哈希,而不是快速的通用哈希函数。
Argon2id 与 bcrypt:您应该选择哪一个?
| 特性 | Argon2id | bcrypt |
|---|---|---|
| 主要防御 | 内存和计算成本 | 计算成本 |
| 内存硬性 | 是 | 否 |
| 可配置参数 | 内存、迭代、并行度 | 成本因子 |
| 密码输入限制 | 无 bcrypt 风格的 72 字节限制 | 72 字节 |
| 在 PHP 中的可用性 | 取决于构建 | 广泛可用 |
| 最佳适用场景 | 新密码存储的首选 | 兼容性和遗留系统 |
Argon2id 旨在抵御受益于大规模并行硬件的攻击。bcrypt 仍然是一种合法的自适应密码哈希算法,但其输入限制需要小心:它最多考虑前 72 个 字节,而不是字符。
不要假定 PASSWORD_DEFAULT 选择 Argon2id。 PHP password_hash 文档 目前记录 bcrypt 为其默认算法。PHP 8.4 将 bcrypt 的默认成本从 10 提高到 12,这说明了为什么依赖隐式参数会在升级后改变应用程序性能。
第一步:检查 Argon2id 支持
Argon2id 不一定在每个托管环境中都可用。在选择之前检查运行时环境:
<?php
declare(strict_types=1);
if(in_array('argon2id', password_algos(), true)) {
echo 'Argon2id is available';
} else {
echo 'Argon2id is not available';
}
可用性取决于 PHP 的构建方式。不要假定升级 PHP 版本会自动启用 Argon2id。
第二步:使用 Argon2id 哈希密码
OWASP 记录了几种可接受的基线配置。一种使用 19 MiB 内存、两次迭代和一次并行。PHP 以 KiB 表示 memory_cost,因此 19 MiB 是 19 * 1024 KiB。
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
$password = 'example-user-password';
$hash = password_hash(
$password,
PASSWORD_ARGON2ID,
$options
);
并行选项 threads 在某些 Argon2 后端(包括 libargon2)中受支持,但并非每个 PHP 构建都支持。如果受支持,值为 1 与此基线匹配;省略它更具可移植性。对实际配置进行基准测试。
生成的编码哈希包括算法标识符、参数和盐。无需将这些值保存在单独的数据库列中。只要 VARCHAR(255) 列存储整个编码值,它就是现代密码哈希的合理起点。
这些是基线参数,不是通用的生产配置。 在现实的并发身份验证流量下测试延迟和内存使用情况。
第三步:正确验证凭据

由于每个密码哈希都使用随机盐,因此生成新哈希并比较字符串是行不通的。使用 password_verify():
<?php
declare(strict_types=1);
$submittedPassword = (string)($_POST['password'] ?? '');
$storedHash = (string)$user['password_hash'];
if(!password_verify($submittedPassword, $storedHash)) {
// Reject authentication without disclosing account existence.
return;
}
// The password is valid. Continue with secure session handling.
PHP 文档 规定 password_verify() 可防止定时攻击。它从存储的哈希中读取算法和工作参数。
密码验证不能替代登录限流、安全会话、HTTPS、适当的错误处理或多因素身份验证。
第四步:在登录期间升级现有密码哈希
password_needs_rehash() 可以检测存储的哈希何时使用了过时的算法或参数。这使得无需强制每个活动用户重置密码即可逐步迁移。
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
if(password_verify($submittedPassword, $storedHash)) {
if(password_needs_rehash(
$storedHash,
PASSWORD_ARGON2ID,
$options
)) {
$newHash = password_hash(
$submittedPassword,
PASSWORD_ARGON2ID,
$options
);
// Persist with a prepared statement.
// Prefer a conditional UPDATE to avoid overwriting
// a newer hash from a concurrent request.
}
// Finish authentication and rotate the session identifier.
}
仅在成功验证提交的密码 之后 重新哈希。条件更新可以确保存储的哈希仍然与刚刚验证的值匹配。例如,仅在用户 ID 和旧哈希都匹配的地方更新密码哈希。
有关 API 详细信息,请参阅 PHP password_needs_rehash()。
第五步:迁移遗留 MD5 或 SHA-1 哈希
较旧的应用程序可能包含 MD5、SHA-1 或自定义密码格式。此类哈希可能无法始终使用 password_verify() 进行验证。
迁移应遵循受控顺序:
- 使用受信任的元数据或明确、有记录的格式识别遗留格式。
- 仅对仍需要原始遗留方案的账户,使用原始遗留方案验证提交的密码。
- 成功验证后,立即使用
password_hash()创建现代哈希。 - 使用安全的数据库更新替换存储的遗留哈希。
- 迁移完成后,淘汰遗留验证。
当多种格式可能时,不要仅根据哈希长度猜测算法。不要尝试解密密码哈希:哈希不是加密。
对于从未登录的账户,考虑密码重置策略,而不是无限期保留弱哈希。不要为新注册用户引入接受弱哈希的不安全回退路径。
第六步:在您的基础设施上基准测试哈希
正确的成本参数取决于您的硬件、并发登录量和延迟要求。
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
$start = hrtime(true);
$hash = password_hash(
'benchmark-password',
PASSWORD_ARGON2ID,
$options
);
$milliseconds = (hrtime(true) - $start) / 1_000_000;
echo round($milliseconds, 2) . ' ms';

仅在受控环境中运行此操作,而不是作为公共 Web 端点。也要测量验证,并在代表性负载下重复。一个在孤立情况下看起来很快的设置,当许多请求同时到达时可能会耗尽内存。
OWASP 建议在安全与运营能力之间取得平衡,并通常将单个哈希操作保持在一秒以下。
常见密码哈希错误
手动添加固定盐。 PHP 已经为其密码 API 生成安全的盐。固定盐会移除重要的保护。
使用原始 MD5、SHA-1 或 SHA-256。 这些算法本身对于密码存储来说太快了。
忽略 bcrypt 的 72 字节限制。 多字节 UTF-8 字符可能比用户预期的更快达到此限制。
选择极端的成本设置。 过多的内存或 CPU 需求可能在身份验证端点造成拒绝服务风险。
记录提交的密码。 避免通过调试日志、监控系统或错误报告暴露凭据。
假定密码哈希可以解决身份验证安全问题。 速率限制、泄露响应、会话安全和多因素身份验证仍然很重要。
您应该使用胡椒粉吗?
胡椒粉是保留在密码数据库之外的附加共享秘密。与盐不同,它不与每个哈希一起存储。
如果攻击者仅窃取数据库,设计良好的胡椒粉可以提供深度防御。但胡椒粉引入了密钥管理和轮换复杂性:丢失或轮换胡椒粉可能需要重置密码。
不要通过将硬编码秘密与每个密码拼接来临时发挥。遵循有记录的策略,单独存储秘密并计划轮换。OWASP 讨论了哈希前和哈希后的胡椒粉方法。
实用的密码哈希策略
对于新的 PHP 应用程序,当可用时优先选择 Argon2id,从与 OWASP 对齐的配置开始,对其进行基准测试并存储完整的编码哈希。在 Argon2id 不可用的地方,如果理解其成本和输入限制,则通过 PHP 密码 API 使用 bcrypt 是一个实用的替代方案。
对于现有应用程序,在成功身份验证后升级受支持的遗留哈希的同时,继续验证它们。在原始密码不可用时,避免破坏性迁移。
从一开始就为升级而设计。 硬件和建议在变化;您的身份验证系统应该能够采用更好的参数和算法,而无需同时更改每个用户的密码。
常见问题解答
Argon2id 比 bcrypt 更好吗?
Argon2id 提供可配置的内存硬性,是 OWASP 对新密码存储实现的首选。
PHP 默认使用 Argon2id 吗?
不。PHP 的 PASSWORD_DEFAULT 目前选择 bcrypt。当支持时,显式使用 PASSWORD_ARGON2ID。
我可以在不重置密码的情况下迁移 bcrypt 哈希吗?
可以。验证现有哈希,然后在成功登录后重新哈希提交的密码。
我应该单独存储盐吗?
不。PHP 的密码哈希 API 生成盐并将所需信息存储在编码哈希中。
SHA-256 对密码安全吗?
本身不安全。使用专用的自适应密码哈希算法,而不是原始 SHA-256。