(PHP 5 >= 5.5.0, PHP 7, PHP 8)
password_needs_rehash — 檢測散列值是否匹配指定的選項
$hash, string|int|null $algo, array $options = []): bool此函數檢測指定的散列值是否實(shí)現了提供的算法和選項。 如果沒(méi)有，需要重新生成散列值。
hash一個(gè)由 password_hash() 創(chuàng )建的散列值。
algo一個(gè)用來(lái)在散列密碼時(shí)指示算法的密碼算法常量。
options一個(gè)包含有選項的關(guān)聯(lián)數組。詳細的參數說(shuō)明，請參考文檔 密碼算法常數。
如果散列需要重新生成才能匹配指定的 algo 和 options，
則返回 true，否則返回 false。
| 版本 | 說(shuō)明 |
|---|---|
| 7.4.0 |
現在 algo 參數可以支持 string 類(lèi)型，但為了向后兼容性，同時(shí)支持
int 類(lèi)型。
|
示例 #1 password_needs_rehash()用法
<?php
$password = 'rasmuslerdorf';
$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';
// 當硬件性能得到改善時(shí)，cost 參數可以再修改
$options = array('cost' => 11);
// 根據明文密碼驗證儲存的散列
if (password_verify($password, $hash)) {
// 檢測是否有更新的可用散列算法
// 或者 cost 發(fā)生變化
if (password_needs_rehash($hash, PASSWORD_DEFAULT, $options)) {
// 如果是這樣，則創(chuàng )建新散列，替換舊散列
$newHash = password_hash($password, PASSWORD_DEFAULT, $options);
}
// 使用戶(hù)登錄
}
?>