関数・クラス解説
password_needs_rehash
version:PHP 5 >= 5.5.0, PHP 7 (公式)指定したハッシュがオプションにマッチするかどうかを調べる
公式リファレンス
書式
password_needs_rehash ( string $hash , mixed $algo [, array $options ] ) : bool
説明
指定したハッシュが、特定のアルゴリズムとオプションを満たしているかどうかを調べます。 満たしていない場合は、ハッシュを再計算する必要があるとみなします。
パラメータ
- hash
- password_hash() が作ったハッシュ。
- algo
- パスワードのハッシュに使うアルゴリズムを表すパスワードアルゴリズム定数。
- options
- オプションを含む連想配列。各アルゴリズムがサポートするオプションについては、パスワードアルゴリズム定数のページを参照ください。
返値
指定した algo と options にマッチするためにハッシュの再計算が必要な場合は TRUE、 それ以外の場合は FALSE を返します。
更新履歴
| バージョン | 説明 |
|---|---|
| 7.4.0 | algo パラメータは string を期待するようになりました。 しかし、後方互換性のために int も未だ受け入れています。 |
サンプル
例1 password_needs_rehash() の使用例
$password = 'rasmuslerdorf';
$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';
// cost パラメータは、ハードウェアの性能の向上にあわせて変えることができます
$options = array('cost' => 11);
// 格納されたハッシュを、平文のパスワードに対して検証します
if (password_verify($password, $hash)) {
// より新しいハッシュアルゴリズムの存在や、コストの変更を
// 確認します
if (password_needs_rehash($hash, PASSWORD_DEFAULT, $options)) {
// そんな場合は新しいハッシュを計算して、古いものを置き換えます
$newHash = password_hash($password, PASSWORD_DEFAULT, $options);
}
// ログイン
}
ワード検索
※入力キーワードが、関数名・説明文・タグに含まれるものを検索関数名アルファベット別
最終更新一覧
●stristr
大文字小文字を区別せず文字列を検索し、ヒット箇所以降（あるいは以前）の文字列を返却
●stripslashes
バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く
●stripos
大文字小文字を区別せずに文字列が最初に現れる位置を取得する
●stripcslashes
addcslashes() でクォートされた文字列をアンクォートする
●strip_tags
文字列から HTML と PHP のタグを除去して返却
●strcspn
指定した文字が最初に現れる位置を調べる
●strcoll
ロケールに基づいて2つの文字列を比較し同じか（あるいは大小）を判定する
●strcmp
2つの文字列を比較し同じか（あるいは大小）を判定する
●strchr
strstr() のエイリアス
●strcasecmp
2つの文字列を比較（大文字小文字を区別せず同じとみなす）
カテゴリー一覧
PHP の振る舞いの変更
音声フォーマットの操作
認証サービス
コマンドライン関連
圧縮およびアーカイブ
暗号
データベース関連
日付および時刻関連
ファイルシステム
自然言語および文字エンコーディング
画像処理および作成
メール関連
数学
テキスト以外の MIME 型
プロセス制御
その他の基本モジュール
その他のサービス
検索エンジン用の拡張モジュール
サーバー固有のモジュール
セッション関連
テキスト処理
変数・データ型関連
ウェブサービス
Windows 用のモジュール
XML 操作
GUI用の拡張モジュール