Question

wp_set_password( string $password,  int $user_id )

Updates the user’s password with a new encrypted one.

---

description

For integration with other applications, this function can be overwritten to instead use the other package password checking algorithm.

Please note: This function should be used sparingly and is really only meant for single-time application. Leveraging this improperly in a plugin or theme could result in an endless loop of password resets if precautions are not taken to ensure it does not execute on every page load.

---

参数

$password

(string) (Required) The plaintext new user password

$user_id

(int) (Required) User ID

---

源代码

File: wp-includes/pluggable.php

function wp_set_password( $password, $user_id ) {
	global $wpdb;

	$hash = wp_hash_password( $password );
	$wpdb->update($wpdb->users, array('user_pass' => $hash, 'user_activation_key' => ''), array('ID' => $user_id) );

	wp_cache_delete($user_id, 'users');
}

---

更新日志

Version	description
2.5.0	Introduced.

---

相关函数

Uses

• wp-includes/cache.php: wp_cache_delete()
• wp-includes/pluggable.php: wp_hash_password()
• wp-includes/wp-db.php: wpdb::update()

---

Used By

• wp-includes/pluggable.php: wp_check_password()
• wp-includes/user.php: reset_password()

---

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

   Below is an example showing how to update a user’s password

   
   <?php
   $user_id = 1;
   $password = 'HelloWorld';
   wp_set_password( $password, $user_id );
   ?>
   

   Please note: This code should be deleted after ONE page load, otherwise the password will be reset on every subsequent load, sending the user back to the login screen each time.