# wp_login()

URL: https://chugunov.pro/api-wordpress/functions/wp_login/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 1.2.2.

> Устаревший элемент. Помечен устаревшим с версии 2.5.0.

## Сигнатура

```php
wp_login( string $username, string $password, string $deprecated = '' ): bool
```

## Описание

Используйте глобальную переменную $error , чтобы узнать причину неудачного входа. Если имя пользователя пустое, ошибка не будет установлена, поэтому в этом случае считайте, что имя пользователя пустое.
Плагины, расширяющие эту функцию, также должны предоставлять глобальную переменную $error и указывать, в чём заключается ошибка, чтобы те, кто проверяет эту глобальную переменную для выяснения причины сбоя, могли воспользоваться ею позже.
См. alsowp_signon()

## Параметры

- `$username` `string` — обязательный. Имя пользователя (username)
- `$password` `string` — обязательный. Пароль пользователя
- `$deprecated` `string` — необязательный, по умолчанию `''`. Не используется

## Возвращаемое значение

`bool`

## Исходный код

Файл: `wp-includes/pluggable-deprecated.php:179`

```php
function wp_login(
	$username,
	#[\SensitiveParameter]
	$password,
	$deprecated = ''
) {
	_deprecated_function( __FUNCTION__, '2.5.0', 'wp_signon()' );
	global $error;

	$user = wp_authenticate($username, $password);

	if ( ! is_wp_error($user) )
		return true;

	$error = $user->get_error_message();
	return false;
}
```

## История изменений

- 2.5.0 — Deprecated. Use wp_signon()
- 1.2.2 — Introduced.

## Связанные

Использует: [`wp_authenticate`](https://chugunov.pro/api-wordpress/functions/wp_authenticate/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/), [`is_wp_error`](https://chugunov.pro/api-wordpress/functions/is_wp_error/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_login/