Question

wp_authenticate_cookie( WP_User|WP_Error|null $user,  string $username,  string $password )

Authenticate the user using the WordPress auth cookie.

---

description

---

参数

$user

(WP_User|WP_Error|null) (Required) WP_User or WP_Error object from a previous callback. Default null.

$username

(string) (Required) Username. If not empty, cancels the cookie authentication.

$password

(string) (Required) Password. If not empty, cancels the cookie authentication.

---

返回值

(WP_User|WP_Error) WP_User on success, WP_Error on failure.

---

源代码

File: wp-includes/user.php

function wp_authenticate_cookie($user, $username, $password) {
	if ( $user instanceof WP_User ) {
		return $user;
	}

	if ( empty($username) && empty($password) ) {
		$user_id = wp_validate_auth_cookie();
		if ( $user_id )
			return new WP_User($user_id);

		global $auth_secure_cookie;

		if ( $auth_secure_cookie )
			$auth_cookie = SECURE_AUTH_COOKIE;
		else
			$auth_cookie = AUTH_COOKIE;

		if ( !empty($_COOKIE[$auth_cookie]) )
			return new WP_Error('expired_session', __('Please log in again.'));

		// If the cookie is not set, be silent.
	}

	return $user;
}

---

更新日志

Version	description
2.8.0	Introduced.

---

相关函数

Uses

• wp-includes/class-wp-user.php: WP_User::__construct()
• wp-includes/l10n.php: __()
• wp-includes/pluggable.php: wp_validate_auth_cookie()
• wp-includes/class-wp-error.php: WP_Error::__construct()

---

User Contributed Notes