wp_password_needs_rehash

説明

bool wp_password_needs_rehash( string $hash [ , string|int $user_id = '' ] )
パスワードハッシュがリハッシュする必要があるか調べる。

パラメータ

  • $hash
    パスワードハッシュを指定。
  • $user_id
    ユーザーIDを指定(省略時は'')。

返り値

パラメータ$hashがリハッシュする必要がある場合はtrueを、それ以外はfalseを返す。


注意

リハッシュ済みのパスワードハッシュは'$wp'で始まる。パスワードハッシュのアルゴリズムがPASSWORD_BCRYPTで、パラメー$hashが'$wp'で始まっていない場合はリハッシュが必要となる。

パラメータ$user_idは本関数内で使用されておらず、'password_needs_rehash'フィルターに引き継がれている。


使用例

  • パスワードハッシュがリハッシュする必要があるか調べる
    if ( wp_password_needs_rehash( $user->user_pass, $user->ID ) ) :

フィルター

[6.8.0]パスワードハッシュのアルゴリズムを確認するため'wp_hash_password_algorithm'フィルターを呼び出す。パラメータ$algorithmの初期値にはPASSWORD_BCRYPTが格納されている。
$algorithm = apply_filters( 'wp_hash_password_algorithm', $algorithm );
[6.8.0]PHPのpassword_needs_rehash関数のために'wp_hash_password_options'フィルターを呼び出す。パラメータ$optionsの初期値には空の配列が、$algorithmには'wp_hash_password_algorithm'フィルターの結果が格納されている。
$options = apply_filters( 'wp_hash_password_options', $options, $algorithm );
[6.8.0]結果を返す前に'password_needs_rehash'フィルターを呼び出す。パラメータ$needs_rehashには判定結果が、$hashおよび$user_idには本関数が受け取った内容がが格納されている。
return apply_filters( 'password_needs_rehash', $needs_rehash, $hash, $user_id );

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/pluggable.php

最終更新 : 2025年04月16日 10:55


お勧め

投稿情報を連想配列で参照する(2018年5月27日 更新)

投稿情報は、タイトルや本文、投稿日時といったいくつかのデータが含んでおり、多くの場合オブジェクトになっている。これを連想配列で扱いたい場合はキャストして型変換することが多かった。基本的にはキャストで問題ないのだが、ふと目に留まったto_arrayメソッドが興味深かったのでメモとして残しておく。

WordPressのコーディングスタンダードとPSR-2がかみ合わない(2018年5月27日 更新)

先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon(4.6)」から「Oxygen(4.7)」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style(Formatter)」が「PSR-2」に設定されていることが原因だった。

続テーマを変更せずにWebフォントを使ってみた(2022年2月8日 更新)

先日投稿した「テーマを変更せずにWebフォントを使ってみた」では、テーマ「Twenty Twenty One」でWebフォントを使うことができた。その後、ほかのテーマで試したところ、そのままではWebフォントを使うことができなかった。今回は、それらのテーマの対応について紹介する。

ブロックエディターで現在の「ロケール」を取得した時のメモ(2024年8月10日 更新)

ブロックエディター向けのプラグインで日本語固有の機能を実装する際、現在のロケール(言語)を取得したい。ブロックエディターの編集時、投稿を編集しているユーザーの言語が優先され、それをどうやって取得するかを「ChatGPT」に聞いてみたのだが。。。

スマートフォン向けの振り分けを自前で行う(2012年1月23日 更新)

PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。