PHP 密碼加密最佳實踐：從 MD5 到 Password Hashing API

密碼儲存安全是 Web 開發底線。本文梳理演進歷程：MD5/SHA1 (已淘汰) → SHA256/512 + Salt → Bcrypt/crypt → PHP 5.5+ Password Hashing API (推薦標準)，並詳細說明 password_hash()、password_verify()、password_needs_rehash()、password_get_info() 四大函數用法與遷移策略。

歷史方法對比

Password Hashing API 完整指南

// 1. 雜湊 (預設 Bcrypt, Cost=10)
$hash = password_hash($password, PASSWORD_DEFAULT);
// 或指定 Argon2id (PHP 7.2+)
$hash = password_hash($password, PASSWORD_ARGON2ID, ['memory_cost' => 1<<17, 'time_cost' => 4, 'threads' => 2]);

// 2. 驗證
if (password_verify($inputPassword, $hash)) {
    // 登入成功
    // 3. 檢查是否需重新雜湊 (如 Cost 變更、演算法升級)
    if (password_needs_rehash($hash, PASSWORD_DEFAULT, ['cost' => 12])) {
        $newHash = password_hash($inputPassword, PASSWORD_DEFAULT, ['cost' => 12]);
        // 更新資料庫
    }
}

// 4. 取得雜湊資訊
$info = password_get_info($hash);
/*
[
    'algo' => 1,           // PASSWORD_BCRYPT
    'algoName' => 'bcrypt',
    'options' => ['cost' => 10]
]
*/

資料庫欄位設計

• password VARCHAR(255)：足夠容納 Bcrypt (60 字元)、Argon2id (98 字元) 及未來演算法。
• **不要** 限制長度為 32/40/64 (MD5/SHA1 長度)。

遷移策略 (舊系統升級)

// 登入時無縫遷移
if (password_verify($input, $storedHash)) {
    if (password_needs_rehash($storedHash, PASSWORD_DEFAULT)) {
        $newHash = password_hash($input, PASSWORD_DEFAULT);
        // UPDATE users SET password = ? WHERE id = ?
    }
    // 登入成功
} else {
    // 兼容舊 MD5：驗證舊雜湊並升級
    if (md5($input) === $storedHash) {
        $newHash = password_hash($input, PASSWORD_DEFAULT);
        // UPDATE ...
        // 登入成功
    } else {
        // 失敗
    }
}

常見誤區

• ❌ password_hash(password_hash($pwd)) 雙重雜湊 → 降低安全性、浪費效能。
• ❌ 自行生成 Salt 傳給 password_hash → 破壞內建機制，除非極特殊需求。
• ❌ 將雜湊視為機密金鑰 → 雜湊可公開儲存，安全性在於單向不可逆與 Cost。
• ✅ Cost 值隨硬體升級定期調高 (如每年 +1)，透過 needs_rehash 平滑遷移。