Question

wp_create_user( string $username,  string $password,  string $email = '' )

A simpler way of inserting a user into the database.

---

description

Creates a new user with just the username, password, and email. For more complex user creation use wp_insert_user() to specify more information.

---

参数

$username

(string) (Required) The user's username.

$password

(string) (Required) The user's password.

$email

(string) (Optional) The user's email.

Default value: ''

---

返回值

(int|WP_Error) The newly created user's ID or a WP_Error object if the user could not be created.

---

源代码

File: wp-includes/user.php

function wp_create_user($username, $password, $email = '') {
	$user_login = wp_slash( $username );
	$user_email = wp_slash( $email    );
	$user_pass = $password;

	$userdata = compact('user_login', 'user_email', 'user_pass');
	return wp_insert_user($userdata);
}

---

更新日志

Version	description
2.0.0	Introduced.

---

相关函数

Uses

• wp-includes/formatting.php: wp_slash()
• wp-includes/user.php: wp_insert_user()

---

Used By

• wp-admin/includes/upgrade.php: wp_install()
• wp-includes/deprecated.php: create_user()
• wp-includes/user.php: register_new_user()
• wp-includes/ms-functions.php: wpmu_create_user()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Basic Example

   As used in wp-admin/upgrade-functions.php:

   
   $user_id = username_exists( $user_name );
   
   if ( ! $user_id && false == email_exists( $user_email ) ) {
   	$random_password = wp_generate_password( $length = 12, $include_standard_special_chars = false );
   	$user_id = wp_create_user( $user_name, $random_password, $user_email );
   } else {
   	$random_password = __( 'User already exists.  Password inherited.', 'textdomain' );
   }