# username_exists()

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

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

## Сигнатура

```php
username_exists( string $username ): int|false
```

## Описание

Дополнительные сведения об этой и похожих функциях темы см. в статье о Conditional Tags в Theme Developer Handbook.

## Параметры

- `$username` `string` — обязательный. Имя пользователя для проверки существования.

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

`int|false`

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

Файл: `wp-includes/user.php:2062`

```php
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 );
}
```

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

- 2.0.0 — Introduced.

## Связанные

Использует: [`get_user_by`](https://chugunov.pro/api-wordpress/functions/get_user_by/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`wp_install`](https://chugunov.pro/api-wordpress/functions/wp_install/), [`edit_user`](https://chugunov.pro/api-wordpress/functions/edit_user/), `WP_Importer::set_user`, [`register_new_user`](https://chugunov.pro/api-wordpress/functions/register_new_user/), [`wp_insert_user`](https://chugunov.pro/api-wordpress/functions/wp_insert_user/), [`wpmu_activate_signup`](https://chugunov.pro/api-wordpress/functions/wpmu_activate_signup/), [`wpmu_validate_user_signup`](https://chugunov.pro/api-wordpress/functions/wpmu_validate_user_signup/), [`wpmu_validate_blog_signup`](https://chugunov.pro/api-wordpress/functions/wpmu_validate_blog_signup/).

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