Функция username_exists() в WordPress

Обзор функции

Функция username_exists() проверяет, существует ли указанный логин (имя пользователя) в базе данных пользователей WordPress. Она ищет имя пользователя в поле user_login.

Для использова��ия функции необходимо подключить файл:

require_once ABSPATH . WPINC . '/user.php';

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

Функция возвращает идентификатор пользователя (user ID), если имя пользователя существует, или false, если такого имени пользователя нет.

int|false — ID пользователя при успешном выполнении, false — при ошибке.

Синтаксис

username_exists( $username );

Параметры:

• $username (string, обязательный): имя пользователя, которое нужно проверить.

Примеры использования

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

В этом примере мы получаем имя пользователя из формы регистрации и проверяем, занято ли оно:

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

Код функции

Вот как выглядит код функции username_exists() в WordPress:

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

    /**
     * Фильтрует, существует ли данное имя пользователя.
     * 
     * @since 4.9.0
     * 
     * @param int|false $user_id  ID пользователя, связанный с именем пользователя,
     *                            или false, если имя пользователя не существует.
     * @param string    $username Имя пользователя для проверки.
     */
    return apply_filters( 'username_exists', $user_id, $username );
}

Связанные функции

Вот несколько функций, которые могут быть полезны при работе с пользователями в WordPress:

• auth_redirect()
• count_user_posts()
• email_exists()
• get_user_by()
• get_userdata()
• sanitize_user()
• validate_username()
• wp_get_current_user()

Эти функции могут быть полезны для выполнения различных операций, связанных с пользователями, например, для проверки существования email или идентификатора пользователя.

Заключение

Функция username_exists() — это полезный инструмент для проверки доступности имени пользователя в WordPress. Она может использоваться при разработке форм регистрации и других функций, связанных с пользователями. Надеемся, что этот обзор помог вам лучше понять, как работает данная функция и как её применить на практике!