指定したハッシュがオプションにマッチするかどうかを調べる

# password_needs_rehash

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

password_needs_rehash — 指定したハッシュがオプションにマッチするかどうかを調べる

### 説明

function 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 の cost パラメータは、ハードウェアの性能の向上にあわせて変えることができます
    $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