| 函數 | 用途 |
|---|---|
password_hash($pwd, $algo, $options) | 生成含鹽值、成本因子的雜湊字串 |
password_verify($pwd, $hash) | 驗證明文密碼與雜湊是否匹配 |
password_needs_rehash($hash, $algo, $options) | 檢查雜湊是否符合當前安全策略(如成本因子過低) |
password_get_info($hash) | 解析雜湊中的演算法、成本等資訊 |
<?php
// 1. 註冊/修改密碼:生成雜湊
$password = 'user_input_password';
// PASSWORD_DEFAULT 目前為 BCRYPT,未來可能升級為 ARGON2I/ARGON2ID
$hash = password_hash($password, PASSWORD_DEFAULT);
// 儲存 $hash 到資料庫(長度 60+ 字元,預留 255 欄位)
// 2. 登入驗證
if (password_verify($inputPassword, $storedHash)) {
echo '密碼正確,登入成功';
// 3. 檢查是否需重新雜湊(如 PHP 升級、策略變更)
if (password_needs_rehash($storedHash, PASSWORD_DEFAULT)) {
$newHash = password_hash($inputPassword, PASSWORD_DEFAULT);
// 更新資料庫中的 hash
}
} else {
echo '密碼錯誤';
}
// 4. 查看雜湊資訊
var_dump(password_get_info($hash));
/*
array(3) {
["algo"]=> int(1) // PASSWORD_BCRYPT
["algoName"]=> string(6) "bcrypt"
["options"]=> array(1) { ["cost"]=> int(10) }
}
*/
?>
// 成本因子越高,運算越慢,越安全。預設 10(2^10 輪)。
// 根據伺服器效能測試,目標單次運算 100-300ms。
$hash = password_hash($password, PASSWORD_BCRYPT, ['cost' => 12]);
// PHP 7.2+ 支援 Argon2(記憶體硬化,抗 GPU 更強)
$hash = password_hash($password, PASSWORD_ARGON2ID, [
'memory_cost' => 1 << 17, // 128 MB
'time_cost' => 4, // 4 次迭代
'threads' => 2, // 2 執行緒
]);
password_hash() 產生的雜湊**只能用 PHP 驗證**(或移植相同演算法的庫)。若系統需跨語言(Node.js, Go, Java 等)驗證,可考慮:
PBKDF2、Argon2 有成熟跨語言實現的演算法。password_hash 欄位,password_algo 標記演算法。password_hash 為空 → 用舊方式驗證 → 成功後用 password_hash() 生成新雜湊存入 → 清空舊欄位。