wp_login()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_login( string $username, string $password, string $deprecated = '' ): boolОписание
Используйте глобальную переменную $error , чтобы узнать причину неудачного входа. Если имя пользователя пустое, ошибка не будет установлена, поэтому в этом случае считайте, что имя пользователя пустое.
Плагины, расширяющие эту функцию, также должны предоставлять глобальную переменную $error и указывать, в чём заключается ошибка, чтобы те, кто проверяет эту глобальную переменную для выяснения причины сбоя, могли воспользоваться ею позже.
См. alsowp_signon()
Оригинал (английский)
Use the global $error to get the reason why the login failed. If the username is blank, no error will be set, so assume blank username on that case.
Plugins extending this function should also provide the global $error and set what the error is, so that those checking the global for why there was a failure can utilize it later.
Параметры
$username
string
обязательный
$password
string
обязательный
$deprecated
string
необязательный
= ''
Возвращаемое значение
bool
Исходный код
wp-includes/pluggable-deprecated.php:179
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. |
