password_hash() 函數用于創建密碼的散列(hash)
PHP 版本要求: PHP 5 >= 5.5.0, PHP 7
語法
string password_hash ( string $password , int $algo [, array $options ] )
password_hash() 使用足夠強度的單向散列算法創建密碼的散列(hash)。 password_hash() 兼容 crypt()。 所以, crypt() 創建的密碼散列也可用于 password_hash()。
當前支持的算法:
PASSWORD_DEFAULT
?- 使用 bcrypt 算法 (PHP 5.5.0 默認)。 注意,該常量會隨著 PHP 加入更新更高強度的算法而改變。 所以,使用此常量生成結果的長度將在未來有變化。 因此,數據庫里儲存結果的列可超過60個字符(最好是255個字符)。PASSWORD_BCRYPT
?- 使用?CRYPT_BLOWFISH
?算法創建散列。 這會產生兼容使用 "$2y$" 的?crypt()。 結果將會是 60 個字符的字符串, 或者在失敗時返回?FALSE
。PASSWORD_ARGON2I
?- 使用 Argon2 散列算法創建散列
PASSWORD_BCRYPT 支持的選項:
salt(string) - 手動提供散列密碼的鹽值(salt)。這將避免自動生成鹽值(salt)。
省略此值后,password_hash() 會為每個密碼散列自動生成隨機的鹽值。這種操作是有意的模式。
注意:鹽值(salt)選項從 PHP 7.0.0 開始被廢棄(deprecated)了。 現在最好選擇簡單的使用默認產生的鹽值。
cost (integer) -
cost
?是?PASSWORD_BCRYPT
?算法特有的參數,用于指定哈希計算的迭代次數(復雜度)。其值是一個整數,范圍為?4 到 31(默認值為 10)。- 例如:
cost=10
?表示迭代 2^10=1024 次;cost=11
?則為 2048 次,以此類推。 - 原理:
cost
?的值每增加 1,哈希計算的時間大約會翻倍(因為迭代次數是 2^cost)。 - 安全性:更高的?
cost
?意味著破解哈希(如暴力破解、彩虹表攻擊)需要更長時間,安全性更高。 - 性能:更高的?
cost
?會增加服務器計算耗時,可能影響請求響應速度(尤其是高并發場景)
- 例如:
?
PASSWORD_ARGON2I 支持的選項:
memory_cost?(integer) - 計算 Argon2 散列時的最大內存(單位:字節 byte)。默認值:?
PASSWORD_ARGON2_DEFAULT_MEMORY_COST
。time_cost?(integer) - 計算 Argon2 散列時最多的時間。默認值:?
PASSWORD_ARGON2_DEFAULT_TIME_COST
。threads?(integer) - 計算 Argon2 散列時最多的線程數。默認值:?
PASSWORD_ARGON2_DEFAULT_THREADS
。
返回值
返回散列后的密碼, 或者在失敗時返回 FALSE。
實例 1
<?php
/*** 在這個案例里,我們為 BCRYPT 增加 cost 到 12。* 注意,我們已經切換到了,將始終產生 60 個字符。*/
$options = ['cost' => 12,
];
echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options);
?>
輸出結果為:
$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a
實例 2
<?php
/*** 在這個案例里,我們為 BCRYPT 增加 cost 到 12。* 注意,我們已經切換到了,將始終產生 60 個字符。*/
$options = ['cost' => 12,
];
echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options);
?>
輸出結果為:
$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
實例 4
尋找最佳 cost 的 password_hash() 例子
<?php
/*** 這個例子對服務器做了基準測試(benchmark),檢測服務器能承受多高的 cost* 在不明顯拖慢服務器的情況下可以設置最高的值* 8-10 是個不錯的底線,在服務器夠快的情況下,越高越好。* 以下代碼目標為 ≤ 50 毫秒(milliseconds),* 適合系統處理交互登錄。*/
$timeTarget = 0.05; // 50 毫秒(milliseconds) $cost = 8;
do {$cost++;$start = microtime(true);password_hash("test", PASSWORD_BCRYPT, ["cost" => $cost]);$end = microtime(true);
} while (($end - $start) < $timeTarget);echo "Appropriate Cost Found: " . $cost;
?>
輸出結果為:
Appropriate Cost Found: 10