update_user_meta()

根据用户ID更新用户元字段。

原型

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

描述

使用$ prev_value参数来区分具有相同密钥和用户ID的元字段。

参数

$user_id (int) (Required) 用户身份。

$meta_key (string) (Required) 元数据键。

$meta_value (mixed) (Required) 元数据价值。

$prev_value (mixed) (Optional)  要删除之前要检查的上一个值。

返回值

(int|bool)  如果密钥不存在则为元ID，成功更新时为true，失败时为false。

源文件

路径：wp-includes/user.php

<?php
...
function update_user_meta($user_id, $meta_key, $meta_value, $prev_value = '') {
	return update_metadata('user', $user_id, $meta_key, $meta_value, $prev_value);
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/update_user_meta/