PHP crypt() 單向加密實現用戶認證：原理、代碼與安全遷移指南

現代標準：password_hash / password_verify

PHP 5.5+ 內建，自動處理算法選擇、Salt 生成、成本因子、驗證：

 12]);
// $2y$12$xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

// 驗證（自動從 hash 解析算法、salt、cost）
if (password_verify('input_pass', $hash)) {
    echo '驗證通過';
}

// 檢查是否需重新哈希（算法升級、cost 變更）
if (password_needs_rehash($hash, PASSWORD_DEFAULT, ['cost' => 14])) {
    $newHash = password_hash('StrongPass123!', PASSWORD_DEFAULT, ['cost' => 14]);
    // 更新資料庫
}

遷移指南：從 crypt() 到 password_hash

prepare("SELECT id, password_hash FROM users WHERE username = ?");
    $stmt->execute([$username]);
    $user = $stmt->fetch();
    
    if (!$user) return null; // 用戶不存在（用固定時間延遲防枚舉）
    
    // 情況1：已是 password_hash 格式
    if (str_starts_with($user['password_hash'], '$2y$') || 
        str_starts_with($user['password_hash'], '$argon2')) {
        if (password_verify($password, $user['password_hash'])) {
            // 檢查需否升級
            if (password_needs_rehash($user['password_hash'], PASSWORD_DEFAULT)) {
                $newHash = password_hash($password, PASSWORD_DEFAULT);
                $pdo->prepare("UPDATE users SET password_hash = ? WHERE id = ?")
                    ->execute([$newHash, $user['id']]);
            }
            return $user;
        }
    }
    // 情況2：舊 crypt() 格式（如 $1$ MD5 或 DES）
    elseif (verifyLegacyCrypt($password, $user['password_hash'])) {
        // 驗證通過，升級為現代哈希
        $newHash = password_hash($password, PASSWORD_DEFAULT);
        $pdo->prepare("UPDATE users SET password_hash = ? WHERE id = ?")
            ->execute([$newHash, $user['id']]);
        return $user;
    }
    
    return null; // 密碼錯誤
}

function verifyLegacyCrypt(string $password, string $hash): bool {
    // 兼容舊 crypt 驗證
    return hash_equals(crypt($password, $hash), $hash);
}

總結

• crypt() 是歷史產物，新代碼嚴禁使用
• 現代標準：password_hash() + password_verify() + PASSWORD_DEFAULT
• 資料庫欄位：VARCHAR(255) 足夠存儲所有算法哈希
• 遷移策略：登入時驗證舊哈希 → 升級為新哈希 → 覆蓋存儲
• 防禦深度：HTTPS、速率限制、雙因子認證、密碼策略、日誌審計