「関数リファレンス/wp update user」の版間の差分

2017年5月5日 (金) 17:44時点における最新版

説明

この関数はデータベース内の1件のユーザー情報を更新します。更新情報には配列としてユーザーメタ情報の複数の項目を含めることができますが、カスタムユーザーメタフィールドは更新しません。この関数が更新できるメタ情報は wp_insert_user() /en と同じです。

ユーザーメタ情報の項目1つを更新するには、update_user_meta() /en を代わりに使ってください。

新規ユーザーを作成したり、パスワード変更メールを送らずに更新したりするには、wp_insert_user() /en を代わりに使ってください。

参考: 現在ログインしているユーザーのパスワードが更新されると、Cookie はクリアされます!

特記事項

(バージョン3.6より前は) $userdata がキー 'ID' を含まなければ、新規ユーザーが作られてそのユーザー ID が返されます。 バージョン3.6以降、このようなことはありませんが、この動作は将来復活するかもしれません。チケット #16731 を見てください。

使い方

<?php wp_update_user( $userdata ) ?>

パラメータ

$userdata

（mixed） （必須） ユーザー情報の配列、stdClass、WP_User オブジェクトのいずれか。

初期値： なし

戻り値

(mixed) 

成功するとユーザー ID を、それ以外の場合は WP_Error オブジェクトを返します。

用例

以下の例はユーザープロフィールの項目「ウェブサイト」を更新する方法を示します:

<?php
$user_id = 1;
$website = 'http://wordpress.org';

$user_id = wp_update_user( array( 'ID' => $user_id, 'user_url' => $website ) );

if ( is_wp_error( $user_id ) ) {
	// エラー発生、おそらくユーザーが存在しなかった。
} else {
	// 成功!
}		

参考

内部で使用する関数

• get_userdata() - 渡された ID からユーザーに紐づく情報のオブジェクトを返します。
• wp_hash_password() /en
• wp_insert_user() /en - ユーザーを更新したり、存在しない場合に作成するために使われます。
• wp_get_current_user() /en
• wp_clear_auth_cookie() /en
• wp_set_auth_cookie() /en

引数の詳細

配列 $userdata には次の項目を含めることができます。

注意: user_pass は WordPress により自動的にハッシュ化されるため、プレーンテキストである必要があります。

注意: user_pass を更新するとユーザーへ通知メールが送られます。

変更履歴

• 3.5.0: stdClass または WP_User オブジェクトを受け取るようになりました。
• 2.0.0: 新規導入

ソースファイル

wp_update_user() は wp-includes/user.php にあります。

関連項目

wp_insert_user(), wp_create_user()
カレントユーザー関数: get_current_user_id()/ en, get_currentuserinfo(), wp_get_current_user()/ en, wp_set_current_user(), current_user_can(), current_user_can_for_blog()/ en , get_user_meta() /en

最新英語版： WordPress Codex » Function_Reference/wp_update_user （最新版との差分）