与用户合作

添加用户

要添加用户，您可以使用wp_create_user()或wp_insert_user()。

wp_create_user()仅使用用户名、密码和电子邮件参数创建用户，同时wp_insert_user()接受描述用户及其属性的数组或对象。

创建用户

wp_create_user()允许您创建一个新的 WordPress 用户。

笔记：
它用wp_slash() 转义值。PHP compact() 函数用这些值创建一个数组。这wp_insert_user() 执行插入操作。

wp_create_user()有关所用参数的完整说明，请参阅有关的功能参考。

实例创建

// check if the username is taken
$user_id = username_exists( $user_name );

// check that the email address does not belong to a registered user
if ( ! $user_id && email_exists( $user_email ) === false ) {
	// create a random password
	$random_password = wp_generate_password( 12, false );
	// create the user
	$user_id = wp_create_user(
		$user_name,
		$random_password,
		$user_email
	);
}

插入用户

wp_insert_user( $userdata );

笔记：
该函数为大多数预定义属性调用过滤器。

该函数执行创建用户时的操作user_register（用户 ID 不存在）。

profile_update该函数在更新用户时执行操作（用户 ID 存在）。

wp_insert_user()有关所用参数的完整说明，请参阅有关的功能参考。

示例插入

下面是一个示例，显示如何插入新用户并填写网站配置文件字段。

$username  = $_POST['username'];
$password  = $_POST['password'];
$website   = $_POST['website'];
$user_data = [
	'user_login' => $username,
	'user_pass'  => $password,
	'user_url'   => $website,
];

$user_id = wp_insert_user( $user_data );

// success
if ( ! is_wp_error( $user_id ) ) {
	echo 'User created: ' . $user_id;
}

更新用户

wp_update_user()更新数据库中的单个用户。更新数据在数组/对象中传递$userdata。

要更新单个用户元数据，请update_user_meta()改用。要创建新用户，请wp_insert_user()改用。

笔记：
如果正在更新当前用户的密码，则 cookie 将被清除！

wp_update_user()有关所用参数的完整说明，请参阅有关的功能参考。

示例更新

下面的示例显示了如何更新用户的网站配置文件字段。

$user_id = 1;
$website = 'https://wordpress.org';

$user_id = wp_update_user(
	array(
		'ID'       => $user_id,
		'user_url' => $website,
	)
);

if ( is_wp_error( $user_id ) ) {
	// error
} else {
	// success
}

删除用户

wp_delete_user()删除用户并可选择将关联的实体重新分配给另一个用户 ID。

笔记：
deleted_user该函数在删除用户后 执行操作。

警报：
如果 $reassign 参数未设置为有效的用户 ID，则属于已删除用户的所有实体都将被删除！

wp_delete_user()有关所用参数的完整说明，请参阅有关的功能参考。