WordPress函数：update_user_meta 更新用户属性

WordPress函数 update_user_meta 用来更新用户属性。

函数原型：

update_user_meta( int $user_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' ): int|bool

使用$prev_value参数区分具有相同键和用户ID的元字段。 如果用户的元字段不存在，将添加它。

如果键不存在，则返回元ID；如果成功更新，则返回true；如果失败，则返回false；如果传递给函数的值与数据库中的值相同，则返回false。

从现在已弃用的update_usermeta的行为更改： 如果新值为空，Update_user_meta不会删除元数据。 行动是不同的。

函数源码：

function update_user_meta( $user_id, $meta_key, $meta_value, $prev_value = '' ) {
	return update_metadata( 'user', $user_id, $meta_key, $meta_value, $prev_value );
}

使用举例：

$user_id = 1;
$new_value = 'some new value';

// Will return false if the previous value is the same as $new_value.
$updated = update_user_meta( $user_id, 'some_meta_key', $new_value );

// So check and make sure the stored value matches $new_value.
if ( $new_value != get_user_meta( $user_id,  'some_meta_key', true ) ) {
	wp_die( __( 'An error occurred', 'textdomain' ) );
}