update_user_meta

函数
update_user_meta ( $user_id, $meta_key, $meta_value, $prev_value = '' )
参数
  • (int) $user_id User ID.
    Required:
  • (string) $meta_key Metadata key.
    Required:
  • (mixed) $meta_value Metadata value. Must be serializable if non-scalar.
    Required:
  • (mixed) $prev_value Optional. Previous value to check before updating. If specified, only update existing metadata entries with this value. Otherwise, update all entries. Default empty.
    Required:
    Default: (empty)
返回值
  • (int|bool) Meta ID if the key didn't exist, true on successful update, false on failure or if the value passed to the function is the same as the one that is already in the database.
定义位置
相关方法
update_usermetaupdate_term_metaupdate_site_metaupdate_user_statusdelete_user_meta
引入
3.0.0
弃用
-

update_user_meta: 这个函数更新一个用户的元数据。它接收用户ID和元数据的键和值来更新。

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

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

如果该用户的元字段不存在,它将被添加。

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

常见问题

FAQs
查看更多 >