PHP项目密码哈希如何选用算法

wen PHP项目 2026-07-01 23

PHP项目密码哈希算法选型指南：从入门到安全合规

📖 目录导读

为什么密码哈希算法如此重要
主流密码哈希算法对比分析
PHP内置密码哈希函数详解
实战：如何在项目中正确选择哈希算法
常见问答与避坑指南
未来趋势与总结

为什么密码哈希算法如此重要

当用户在网站注册账号时，密码绝不能以明文形式存储在数据库中，如果数据库被泄露，攻击者会直接获取所有用户的原始密码，采用密码哈希（password hashing）技术，将明文密码通过不可逆的数学转换生成固定长度的摘要，即使数据库泄露,攻击者也很难还原原始密码。

PHP项目密码哈希如何选用算法

曾经流行的MD5、SHA1等算法已被证明存在严重安全缺陷，碰撞攻击和彩虹表攻击使它们不再适用于密码存储，根据OWASP（Open Web Application Security Project）最新指南，现代的密码哈希必须同时具备计算缓慢、抗暴力破解、自动加盐三大特性。

问答1：为什么不直接用加密算法而用哈希？ 加密算法是可逆的，意味着持有密钥的人可以反向解密出密码，而哈希是单向函数，理论上无法逆向，密码管理不需要还原原始密码,只需要验证用户输入能否产生相同的哈希值。

主流密码哈希算法对比分析

1 已淘汰的算法

MD5（128位）：计算速度快如闪电，每秒可计算数十亿次，2004年已被破解,产生碰撞只需不到1分钟。
SHA-1（160位）：Google在2017年成功演示了碰撞攻击,Google自身已停止使用。
SHA-256/512：虽未被碰撞攻击，但速度太快，反而不适合密码存储,容易遭受GPU加速暴力破解。

2 当前推荐的算法

算法	推荐来源	抗GPU	抗ASIC
bcrypt	OWASP、NIST	内置	最广泛使用，成本参数可调
argon2	OWASP排名第一	内置(PHP7.2+)	内存硬，抗专用硬件攻击
scrypt	部分金融场景	需ext-sodium	资源密集型，抗ASIC

问答2：为什么说“慢”反而安全？ 攻击者需要尝试数百万个密码组合，如果每个哈希计算需要0.1秒，暴力破解10万次就需要约2.8小时，而MD5只需几毫秒，10万次瞬间完成,参数化慢速哈希可以大幅增加攻击成本。

3 算法详解

bcrypt基于Blowfish密码算法，通过cost参数控制计算时间，PHP中默认cost=10（约0.1秒）,可在性能与安全间权衡。

argon2是2015年密码哈希竞赛的优胜者,有三种变体：

argon2i：针对密码哈希优化，抗时间侧信道攻击
argon2d：对GPU破解抵抗力更强
argon2id：推荐使用，混合前两者优势

PHP内置密码哈希函数详解

PHP从5.5版本开始提供一套完整的密码哈希API，取代了先前混乱的crypt()和md5()组合,核心函数包括：

1 password_hash()

string password_hash(string $password, int|string|null $algo, array $options = [])

推荐用法：

$hash = password_hash($userPassword, PASSWORD_BCRYPT, ['cost' => 12]);
// 或使用 PHP8.0+ 自动选择最优算法
$hash = password_hash($userPassword, PASSWORD_ARGON2ID);

选项参数：

cost（bcrypt）：范围4-31，默认10，每增加1计算时间翻倍
memory_cost（argon2）：内存消耗（KB），默认1024（1MB）
time_cost（argon2）：迭代次数，默认2
threads（argon2）：并行线程数，建议1-8

2 password_verify()

bool password_verify(string $password, string $hash)

注意：该函数自动从哈希字符串中提取算法、参数和盐值,无需手动比对。

if (password_verify($inputPassword, $storedHash)) {
    echo '登录成功';
}

3 password_needs_rehash()

用于检查已存储的哈希是否需要更新算法或成本参数：

if (password_needs_rehash($hash, PASSWORD_ARGON2ID, ['memory_cost' => 2048])) {
    $newHash = password_hash($inputPassword, PASSWORD_ARGON2ID, ['memory_cost' => 2048]);
    // 更新数据库
}

问答3：为什么每个密码的哈希值长度都不一样？ bcrypt输出固定60字符，argon2输出96字符（默认配置），哈希中包含了算法标识符、成本参数、自动生成的盐值（16-22字节）以及最终哈希值，因此长度固定但内容不同,盐值确保相同密码产生不同哈希。

实战：如何在项目中正确选择哈希算法

1 决策流程

用户注册/修改密码
    ↓
是否已迁移到PHP8+？ → 是 → 使用 PASSWORD_ARGON2ID (推荐)
    ↓ 否
PHP7.2+？ → 是 → 使用 PASSWORD_ARGON2I 或 bcrypt
    ↓ 否
PHP5.5-7.1？ → 使用 PASSWORD_BCRYPT（默认）
    ↓
需考虑兼容旧系统 → 使用 bcrypt（最广泛支持）

2 实际代码示例（用户注册）

class PasswordManager {
    private const HASH_ALGORITHM = PASSWORD_ARGON2ID;
    private const OPTIONS = [
        'memory_cost' => 2048, // 2MB
        'time_cost'   => 3,
        'threads'     => 2
    ];
    public function hashPassword(string $plainPassword): string {
        $hash = password_hash($plainPassword, self::HASH_ALGORITHM, self::OPTIONS);
        if ($hash === false) {
            throw new RuntimeException('密码哈希生成失败，请检查服务器配置');
        }
        return $hash;
    }
    public function verifyPassword(string $plainPassword, string $storedHash): bool {
        if (strlen($storedHash) < 60) {
            // 预防非哈希的异常值
            return false;
        }
        return password_verify($plainPassword, $storedHash);
    }
    public function needsRekey(string $storedHash): bool {
        if (!password_verify('test', $storedHash)) {
            // 验证函数正常工作检查
            user_error('数据库中可能包含损坏的哈希', E_USER_WARNING);
        }
        $info = password_get_info($storedHash);
        return ($info['algoName'] !== self::HASH_ALGORITHM) ||
               ($info['options'] !== self::OPTIONS);
    }
}

3 数据库字段设计

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    email VARCHAR(255) NOT NULL UNIQUE,
    password_hash VARCHAR(255) NOT NULL,  -- bcrypt 60字符，argon2 96-128字符
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);