функция
since 2.8.0
wp_authenticate_cookie()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_authenticate_cookie( WP_User|WP_Error|null $user, string $username, string $password ): WP_User|WP_Error
Описание
Аутентифицирует пользователя с помощью cookie авторизации WordPress.
Параметры
$user
WP_User|WP_Error|null
обязательный
Объект WP_User или WP_Error из предыдущей функции обратного вызова. Значение по умолчанию null.
$username
string
обязательный
Имя пользователя. Если не пустое, отменяет аутентификацию по cookie.
$password
string
обязательный
Пароль. Если не пустой, отменяет аутентификацию по cookie.
Возвращаемое значение
WP_User|WP_Error
WP_User WP_Error
Исходный код
wp-includes/user.php:326
function wp_authenticate_cookie(
$user,
$username,
#[\SensitiveParameter]
$password
) {
global $auth_secure_cookie;
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 );
}
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;
}
История изменений
| Версия | Описание |
|---|---|
| 2.8.0 | Introduced. |

