# password_needs_rehash

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

password_needs_rehash — 检测散列值是否匹配指定的选项

### 说明

password_needs_rehash(string `$hash`, string|int|null `$algo`, array `$options` = []): bool

此函数检测指定的散列值是否实现了提供的算法和选项。 如果没有，需要重新生成散列值。

### 参数

`hash`

  一个由 password_hash() 创建的散列值。

`algo`

  一个用来在散列密码时指示算法的密码算法常量。

`options`

  一个包含有选项的关联数组。详细的参数说明，请参考文档 密码算法常数。

### 返回值

如果散列需要重新生成才能匹配指定的 `algo` 和 `options`， 则返回 `true`，否则返回 `false`。

### 更新日志

版本 | 说明
--- | ---
7.4.0 | 现在 `algo` 参数可以支持 string 类型，但为了向后兼容性，同时支持 int 类型。

### 示例

示例 #1 password_needs_rehash()用法

`<?php
$password = 'rasmuslerdorf';
$hash = '$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.';
$algorithm = PASSWORD_BCRYPT;
// bcrypt 的成本参数随着硬件的改进而可能发生变化
$options = ['cost' => 13];
// 根据明文密码验证储存的散列
if (password_verify($password, $hash)) {
// 检查算法或选项是否已经更改
if (password_needs_rehash($hash, $algorithm, $options)) {
// 如果是这样，则创建新散列，替换旧散列
$newHash = password_hash($password, $algorithm, $options);
// 使用 $newHash 更新用户记录
}
// 执行登录
}
?>`
`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open