密碼存儲安全是 Web 應用的生命線。本文梳理 PHP 密碼加密演進史,深度解析 Password Hashing API (PHP 5.5+) 的最佳實踐,並給出生產環境完整落地方案:雜湊、驗證、升級、遷舊、防時序攻擊、配置硬化。
| 算法 | 狀態 | 破解速度 (現代 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+ 內建 |
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]] |
<?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;
}
?>
**嚴禁**直接解密舊雜湊。採用「登入時無感遷移」:
<?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']);
}
?>
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)。password_verify 內建恆時比較,絕不**自行實現**字符串比較驗證密碼**。| 錯誤做法 | 後果 | 正確做法 |
|---|---|---|
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 |
password_hash($pwd, PASSWORD_ARGON2ID, [...options])**。password_verify()**,自動防時序攻擊。password_needs_rehash()**,實現無感算法升級。