get_user_by

Получает пользователя по указанному полю и значению этого поля.

✈ 1 раз = 0.001296с = очень медленно | 50000 раз = 3.27с = быстро

Хуков нет.

Возвращает

WP_User/false. Объект данных о пользователе, если указанное поле не существует, то вернет false.

Использование

$user = get_user_by( $field, $value );
$field(строка) (обязательный)

Поле, по которому нужно получить пользователя. Может быть:

  • id или ID с WP 4.4. – по полю ID
  • slug – по полю user_nicename
  • email – по полю user_email
  • login – по полю user_login

По умолчанию: нет

$value(строка/число) (обязательный)
Значение указанного поля.
По умолчанию: нет

Примеры

#1. Получим пользователя по email

Пример, родной функция WP, в которой используется get_user_by(). Функция получает пользователя по e-mail адресу, если пользователь существует, то будет возвращен его ID.

function email_exists( $email ) {
	if ( $user = get_user_by('email', $email) )
		return $user->ID;

	return false;
}

#2. Получим пользователя по id

$user = get_user_by('id', 1);

$user будет содержать:

<?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;
}