add_user_meta( int $user_id, string $meta_key, mixed $meta_value, bool $unique = false )

向用户添加元数据。
Adds meta data to a user.

目录锚点：#参数#返回#源码#笔记

参数（Parameters）

返回（Return）

（int|false）Meta ID表示成功，false表示失败。

源码（Source）

/**
 * Add meta data field to a user.
 *
 * Post meta data is called "Custom Fields" on the Administration Screens.
 *
 * @since 3.0.0
 * @link https://codex.wordpress.org/Function_Reference/add_user_meta
 *
 * @param int    $user_id    User ID.
 * @param string $meta_key   Metadata name.
 * @param mixed  $meta_value Metadata value.
 * @param bool   $unique     Optional, default is false. Whether the same key should not be added.
 * @return int|false Meta ID on success, false on failure.
 */
function add_user_meta($user_id, $meta_key, $meta_value, $unique = false) {
	return add_metadata('user', $user_id, $meta_key, $meta_value, $unique);
}

笔记（Notes）

实例