username_exists()WP 2.0.0

Проверяет наличие указанного имени пользователя (логина) в базе данных пользователей. Поиск проходит по полю user_login.

Функция требует подключение файла:

require_once ABSPATH . WPINC . '/user.php';
Работает на основе: get_user_by()
Хуки из функции

Возвращает

int|false. ID пользователя, если пользователь найден и false, если пользователь не существует.

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

username_exists( $username );
$username(строка) (обязательный)
Имя пользователя (login), которого нужно проверить.

Примеры

0

#1 Пример проверки имени пользователя при регистрации нового пользователя:

$username = $_POST['username'];
if ( username_exists( $username ) )
	echo "Имя пользователя уже используется!";
else
	echo "Вы можете использовать это имя пользователя!";

Список изменений

С версии 2.0.0 Введена.

Код username_exists() WP 6.4.3

function username_exists( $username ) {
	$user = get_user_by( 'login', $username );
	if ( $user ) {
		$user_id = $user->ID;
	} else {
		$user_id = false;
	}

	/**
	 * Filters whether the given username exists.
	 *
	 * @since 4.9.0
	 *
	 * @param int|false $user_id  The user ID associated with the username,
	 *                            or false if the username does not exist.
	 * @param string    $username The username to check for existence.
	 */
	return apply_filters( 'username_exists', $user_id, $username );
}