PHP password_needs_rehash() 関数
password_hash() 関数は、ハッシュ値が指定されたオプションに一致するかどうかを検出するために使用されます。
PHP バージョン要件: PHP 5 >= 5.5.0, PHP 7
構文
bool password_needs_rehash ( string $hash , int $algo [, array $options ] )
パラメータの説明:
- hash: password_hash() によって作成されたハッシュ値。
- algo: パスワードをハッシュ化する際にアルゴリズムを指定するためのパスワードアルゴリズム定数。
- options: オプションを含む連想配列。現在サポートされているオプションは2つ: salt(パスワードをハッシュ化するときに追加するソルト(干渉文字列))と、cost(アルゴリズムの再帰の階層数を指定するもの)。これらの2つの値の例は crypt() ページにあります。省略すると、ランダムなソルト値とデフォルトの cost が使用されます。
戻り値
この関数は、指定されたハッシュ値が提供されたアルゴリズムとオプションを実装しているかどうかを検出します。そうでない場合は、ハッシュ値を再生成する必要があります。
例
password_needs_rehash() の用法
$password = 'rasmuslerdorf';
$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';
//ハードウェアの性能が向上した場合、cost パラメータを再変更することができます。
$options = array('cost' => 11);
//平文パスワードに基づいて保存されたハッシュを検証します。
if (password_verify($password, $hash)) {
//より新しい利用可能なハッシュアルゴリズムがあるかどうかを検出します。
//または cost が変更された場合
if (password_needs_rehash($hash, PASSWORD_DEFAULT, $options)) {
//その場合は、新しいハッシュを作成して古いハッシュを置き換えます。
$newHash = password_hash($password, PASSWORD_DEFAULT, $options);
}
//ユーザーをログインさせます
}
PHP パスワードハッシュアルゴリズム