array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.password-needs-rehash.php', 1 => 'password_needs_rehash', ), 'up' => array ( 0 => 'ref.password.php', 1 => '密码散列算法函数', ), 'prev' => array ( 0 => 'function.password-hash.php', 1 => 'password_hash', ), 'next' => array ( 0 => 'function.password-verify.php', 1 => 'password_verify', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/password/functions/password-needs-rehash.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
password_needs_rehash — 检测散列值是否匹配指定的选项
此函数检测指定的散列值是否实现了提供的算法和选项。 如果没有,需要重新生成散列值。
hash
一个由 password_hash() 创建的散列值。
algo
一个用来在散列密码时指示算法的密码算法常量。
options
一个包含有选项的关联数组。详细的参数说明,请参考文档 密码算法常数。
示例 #1 password_needs_rehash()用法
<?php
$password = 'rasmuslerdorf';
$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';
$algorithm = PASSWORD_BCRYPT;
// bcrypt 的成本参数随着硬件的改进而可能发生变化
$options = ['cost' => 12];
// 根据明文密码验证储存的散列
if (password_verify($password, $hash)) {
// 检查算法或选项是否已经更改
if (password_needs_rehash($hash, $algorithm, $options)) {
// 如果是这样,则创建新散列,替换旧散列
$newHash = password_hash($password, $algorithm, $options);
// 使用 $newHash 更新用户记录
}
// 执行登录
}
?>