PHP password_needs_rehash() 函數(shù)用法及示例

PHP 密碼散列算法

password_hash() 函數(shù)用于檢測(cè)散列值是否匹配指定的選項(xiàng)。

PHP 版本要求: PHP 5 >= 5.5.0, PHP 7

語法

bool password_needs_rehash ( string $hash , int $algo [, array $options ] )

參數(shù)說明：

• hash: 一個(gè)由 password_hash() 創(chuàng)建的散列值。
• algo: 一個(gè)用來在散列密碼時(shí)指示算法的密碼算法常量。
• options: 一個(gè)包含有選項(xiàng)的關(guān)聯(lián)數(shù)組。目前支持兩個(gè)選項(xiàng)：salt，在散列密碼時(shí)加的鹽（干擾字符串），以及cost，用來指明算法遞歸的層數(shù)。這兩個(gè)值的例子可在 crypt() 頁(yè)面找到。 省略后，將使用隨機(jī)鹽值與默認(rèn) cost。

返回值

此函數(shù)檢測(cè)指定的散列值是否實(shí)現(xiàn)了提供的算法和選項(xiàng)。 如果沒有，需要重新生成散列值。

在線示例

<?php
 
$password = 'rasmuslerdorf';
$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';
 
// 當(dāng)硬件性能得到改善時(shí)，cost 參數(shù)可以再修改
$options = array('cost' => 11);
 
// 根據(jù)明文密碼驗(yàn)證儲(chǔ)存的散列
if (password_verify($password, $hash)) {
    // 檢測(cè)是否有更新的可用散列算法
    // 或者 cost 發(fā)生變化
    if (password_needs_rehash($hash, PASSWORD_DEFAULT, $options)) {
        // 如果是這樣，則創(chuàng)建新散列，替換舊散列
        $newHash = password_hash($password, PASSWORD_DEFAULT, $options);
    }
 
    // 使用戶登錄
}
?>

PHP 密碼散列算法