# get_user_by()

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

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

## Сигнатура

```php
get_user_by( string $field, int|string $value ): WP_User|false
```

## Описание

Извлекает информацию о пользователе по заданному полю.

## Параметры

- `$field` `string` — обязательный. Поле, по которому извлекается пользователь. id | ID | slug | email | login.
- `$value` `int|string` — обязательный. Значение для $field. ID пользователя, слаг, адрес электронной почты или имя для входа.

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

`WP_User|false` — WP_User

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

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

```php
function get_user_by( $field, $value ) {
	$userdata = WP_User::get_data_by( $field, $value );

	if ( ! $userdata ) {
		return false;
	}

	$user = new WP_User();
	$user->init( $userdata );

	return $user;
}
```

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

- 4.4.0 — Added 'ID' as an alias of 'id' for the $field parameter.
- 2.8.0 — Introduced.

## Связанные

Использует: `WP_User::get_data_by`, `WP_User::__construct`.
Используется в: [`get_user`](https://chugunov.pro/api-wordpress/functions/get_user/), `WP_REST_Templates_Controller::get_wp_templates_author_text_field`, [`wpmu_new_site_admin_notification`](https://chugunov.pro/api-wordpress/functions/wpmu_new_site_admin_notification/), [`wp_authenticate_application_password`](https://chugunov.pro/api-wordpress/functions/wp_authenticate_application_password/), `WP_Automatic_Updater::send_plugin_theme_email`, [`populate_network_meta`](https://chugunov.pro/api-wordpress/functions/populate_network_meta/), [`get_object_subtype`](https://chugunov.pro/api-wordpress/functions/get_object_subtype/), [`wp_create_user_request`](https://chugunov.pro/api-wordpress/functions/wp_create_user_request/), [`wp_user_personal_data_exporter`](https://chugunov.pro/api-wordpress/functions/wp_user_personal_data_exporter/), [`wp_media_personal_data_exporter`](https://chugunov.pro/api-wordpress/functions/wp_media_personal_data_exporter/), [`_wp_personal_data_handle_actions`](https://chugunov.pro/api-wordpress/functions/_wp_personal_data_handle_actions/), [`get_user_locale`](https://chugunov.pro/api-wordpress/functions/get_user_locale/), `WP_REST_Users_Controller::create_item`, `WP_REST_Users_Controller::update_item`, [`wp_authenticate_email_password`](https://chugunov.pro/api-wordpress/functions/wp_authenticate_email_password/), [`get_avatar_data`](https://chugunov.pro/api-wordpress/functions/get_avatar_data/), [`retrieve_password`](https://chugunov.pro/api-wordpress/functions/retrieve_password/), `WP_Automatic_Updater::send_email`, `WP_Automatic_Updater::send_debug_email`, [`wp_password_change_notification`](https://chugunov.pro/api-wordpress/functions/wp_password_change_notification/), [`wp_new_user_notification`](https://chugunov.pro/api-wordpress/functions/wp_new_user_notification/), [`wp_notify_postauthor`](https://chugunov.pro/api-wordpress/functions/wp_notify_postauthor/), [`wp_notify_moderator`](https://chugunov.pro/api-wordpress/functions/wp_notify_moderator/), [`wp_validate_auth_cookie`](https://chugunov.pro/api-wordpress/functions/wp_validate_auth_cookie/), [`get_userdata`](https://chugunov.pro/api-wordpress/functions/get_userdata/), [`get_profile`](https://chugunov.pro/api-wordpress/functions/get_profile/), `WP_Query::get_queried_object`, `WP_Query::get_posts`, [`check_password_reset_key`](https://chugunov.pro/api-wordpress/functions/check_password_reset_key/), [`username_exists`](https://chugunov.pro/api-wordpress/functions/username_exists/), [`email_exists`](https://chugunov.pro/api-wordpress/functions/email_exists/), [`wp_authenticate_username_password`](https://chugunov.pro/api-wordpress/functions/wp_authenticate_username_password/), [`get_userdatabylogin`](https://chugunov.pro/api-wordpress/functions/get_userdatabylogin/), [`get_user_by_email`](https://chugunov.pro/api-wordpress/functions/get_user_by_email/), [`wp_setcookie`](https://chugunov.pro/api-wordpress/functions/wp_setcookie/), [`get_pages`](https://chugunov.pro/api-wordpress/functions/get_pages/), [`is_user_spammy`](https://chugunov.pro/api-wordpress/functions/is_user_spammy/), [`wpmu_signup_blog_notification`](https://chugunov.pro/api-wordpress/functions/wpmu_signup_blog_notification/), [`wpmu_signup_user_notification`](https://chugunov.pro/api-wordpress/functions/wpmu_signup_user_notification/), [`is_site_admin`](https://chugunov.pro/api-wordpress/functions/is_site_admin/).

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