萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 密碼處理終極指南:從 MD5 到 Password Hashing API

密碼存儲安全是 Web 應用的生命線。本文梳理 PHP 密碼加密演進史,深度解析 Password Hashing API (PHP 5.5+) 的最佳實踐,並給出生產環境完整落地方案:雜湊、驗證、升級、遷舊、防時序攻擊、配置硬化。

演進時間線:為什麼棄用 MD5/SHA1?

算法狀態破解速度 (現代 GPU)致命缺陷
MD5❌ 禁用~500 億次/秒碰撞攻擊、彩虹表、無鹽值、極快
SHA1❌ 禁用~150 億次/秒同 MD5,SHA-1 碰撞已實現
SHA256/SHA512⚠️ 不推薦單獨用~20-50 億次/秒設計為快速校驗,非密碼存儲;無內建鹽值、成本因子
SHA256 + 隨機鹽⚠️ 可接受但非最佳~同上需自行管理鹽值、迭代次數,易出錯
Bcrypt✅ 推薦 (最低標準)~1-10 萬次/秒 (cost=10)內建鹽值、可調成本、72 字節截斷限制
Argon2id✅ 現代首選可配置記憶體/時間/並行度抗 GPU/ASIC、抗側信道、PHP 7.2+ 內建

Password Hashing API:官方標準,開箱即用

PHP 5.5 引入,封裝 Bcrypt/Argon2,自動處理鹽值生成、成本因子、算法標識、驗證邏輯,**強烈建議所有新項目直接使用**。

核心函數

函數用途關鍵參數
password_hash(string $password, string|int|null $algo, array $options = []): string|false生成雜湊$algo: PASSWORD_DEFAULT (當前 Bcrypt)、PASSWORD_BCRYPT、PASSWORD_ARGON2I、PASSWORD_ARGON2ID (推薦)
password_verify(string $password, string $hash): bool驗證密碼自動解析 $hash 中的算法、鹽值、成本,恆時比較防時序攻擊
password_needs_rehash(string $hash, string|int|null $algo, array $options = []): bool檢查是否需重新雜湊 (算法升級、成本調整)登入成功後調用,滿足條件則重新 password_hash 並更新庫
password_get_info(string $hash): array解析雜湊信息返回 ['algo'=>1, 'algoName'=>'bcrypt', 'options'=>['cost'=>10]]

推薦配置:Argon2id (PHP 7.3+)

<?php
// config/security.php
return [
    'password' => [
        'algo' => PASSWORD_ARGON2ID,     // PHP 7.3+ 支援
        'options' => [
            'memory_cost' => 1 << 16,    // 64 MB (2^16 KB)
            'time_cost'   => 4,          // 迭代 4 次
            'threads'     => 3,          // 並行度 3
        ],
    ],
];

// 使用
$hash = password_hash($password, PASSWORD_ARGON2ID, [
    'memory_cost' => 65536, // 64 MB
    'time_cost'   => 4,
    'threads'     => 3,
]);
// $hash 示例:$argon2id$v=19$m=65536,t=4,p=3$c29tZXNhbHQ$...
?>

驗證與自動升級

<?php
function verifyPassword(string $password, string $hash): bool {
    // 1. 驗證 (恆時比較,防時序攻擊)
    if (!password_verify($password, $hash)) {
        return false;
    }
    
    // 2. 檢查是否需要升級 (算法變更、成本提高)
    if (password_needs_rehash($hash, PASSWORD_ARGON2ID, [
        'memory_cost' => 65536,
        'time_cost'   => 4,
        'threads'     => 3,
    ])) {
        // 3. 重新雜湊並更新數據庫 (異步或同步)
        $newHash = password_hash($password, PASSWORD_ARGON2ID, [
            'memory_cost' => 65536,
            'time_cost'   => 4,
            'threads'     => 3,
        ]);
        // update users set password_hash = ? where id = ?
        updateUserPasswordHash($userId, $newHash);
    }
    
    return true;
}
?>

遷舊策略:從 MD5/SHA1 平滑遷移到現代算法

**嚴禁**直接解密舊雜湊。採用「登入時無感遷移」:

<?php
function legacyVerifyAndUpgrade(string $inputPassword, string $legacyHash, int $userId): bool {
    // 1. 驗證舊算法 (假設舊系統用 md5($password . $salt))
    $legacySalt = getUserLegacySalt($userId); // 從舊表讀取鹽值
    if (md5($inputPassword . $legacySalt) !== $legacyHash) {
        return false; // 密碼錯誤
    }
    
    // 2. 密碼正確,生成新雜湊
    $newHash = password_hash($inputPassword, PASSWORD_ARGON2ID, $options);
    
    // 3. 更新數據庫:密碼欄位寫入新雜湊,標記遷移完成
    $pdo->prepare("UPDATE users SET password_hash = ?, legacy_migrated = 1 WHERE id = ?")
        ->execute([$newHash, $userId]);
    
    return true;
}

// 登入邏輯
if ($user['legacy_migrated']) {
    $ok = verifyPassword($password, $user['password_hash']);
} else {
    $ok = legacyVerifyAndUpgrade($password, $user['password_hash'], $user['id']);
}
?>

資料庫 Schema 設計

CREATE TABLE `users` (
    `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
    `email` VARCHAR(190) NOT NULL,
    `password_hash` VARCHAR(255) NOT NULL COMMENT 'Argon2id 雜湊,長度可變,預留 255',
    `legacy_migrated` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否已從舊算法遷移',
    `password_updated_at` DATETIME NULL COMMENT '最後修改密碼時間,用於強制輪換',
    PRIMARY KEY (`id`),
    UNIQUE KEY `uk_email` (`email`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
  • password_hash 長度:Bcrypt 固定 60 字符,Argon2id 視參數而定 (通常 90-120),建議 VARCHAR(255)。
  • **嚴禁**存儲明文、可逆加密、雙向加密密碼。

進階防護:防時序攻擊、速率限制、多因子認證

  1. 恆時比較:password_verify 內建恆時比較,絕不**自行實現**字符串比較驗證密碼**。
  2. 登入限流:IP + 用戶雙維度限流 (Redis 滑動窗口),失敗 5 次鎖定 15 分鐘,需圖形驗證碼/短信驗證碼解鎖。
  3. 設備指紋/風控:異地登入、新設備觸發二次驗證 (郵箱/短信/OTP/TOTP)。
  4. 密碼策略:最小長度 12、禁止常見弱密碼 (HIBP Pwned Passwords API 檢測)、定期強制輪換 (敏感系統)。
  5. 日誌審計:記錄登入成功/失敗、IP、User-Agent、設備指紋,保留 1 年以上。

常見錯誤避雷

錯誤做法後果正確做法
md5($pass) / sha1($pass)秒級破解password_hash($pass, PASSWORD_ARGON2ID)
自定義 hash('sha256', $pass . $salt)無成本因子,GPU 极快破解使用內建 API,自動管理鹽值、成本
鹽值固定/寫死在代碼彩虹表一次破解全庫API 自動生成加密安全隨機鹽值
雙向加密 (openssl_encrypt)密鑰洩露 = 全庫明文單向雜湊,不可逆
驗證用 $hash === crypt($pass, $hash)非恆時,漏洞百出password_verify($pass, $hash)
密碼欄位 VARCHAR(32/40/60)Argon2id 截斷導致驗證永遠失敗VARCHAR(255) 或 TEXT

總結

  1. **新項目直接用 password_hash($pwd, PASSWORD_ARGON2ID, [...options])**。
  2. **驗證只用 password_verify()**,自動防時序攻擊。
  3. **登入時檢查 password_needs_rehash()**,實現無感算法升級。
  4. **舊系統遷移採用「登入時驗證舊雜湊 → 重新生成新雜湊 → 更新庫」**。
  5. **資料庫欄位 VARCHAR(255)**,配合限流、風控、審計日志構建纵深防禦。
copyright © 萬盛學電腦網 all rights reserved