根据用户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/