Verifica se o hash informado corresponde às opções especificadas

# password_needs_rehash

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

password_needs_rehash — Verifica se o hash informado corresponde às opções especificadas

### Descrição

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

Esta função verifica se o hash fornecido implementa o algoritmo e as opções indicadas. Se não, ela assume que o hash precisa ser recalculado.

### Parâmetros

`hash`

  Um hash criado por password_hash().

`algo`

  Uma constante de algoritmo de senha denotando o algoritmo a ser usado ao fazer o hash da senha.

`options`

  Um array associativo contendo opções. Consulte as constantes de algoritmo de senha para obter a documentação sobre as opções suportadas por cada algoritmo.

### Valor Retornado

Retorna `true` se o hash deve ser recalculado para corresponder ao algortimo informado em `algo` e às opções em `options`, ou `false` caso contrário.

### Registro de Alterações

Versão | Descrição
--- | ---
7.4.0 | O parâmetro `algo` agora espera uma string, mas ainda aceita ints para compatibilidade com versões anteriores.

### Exemplos

Exemplo #1 Utilização de password_needs_rehash()

    <?php

    $password = 'rasmuslerdorf';
    $hash = '$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.';

    $algorithm = PASSWORD_BCRYPT;
    // o parâmetro de custo de bcrypt pode mudar com o tempo com a evloução dos equipamentos
    $options = ['cost' => 13];

    // Verifica o hash armazenado comparando com uma senha em texto puro
    if (password_verify($password, $hash)) {
        // Verifica se o algoritmo ou o custo mudaram
        if (password_needs_rehash($hash, $algorithm, $options)) {
            // Caso positivo, cria um hash novo, e substitui o antigo
            $newHash = password_hash($password, $algorithm, $options);

            // Atualiza o registro do usuário com $newHash
        }

        // Faz login
    }
    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open