Проверка имени пользователя (VALIDATE_USERNAME) в WordPress

Функция validate_username() в WordPress предназначена для проверки корректности имени пользователя (логина). В этой статье мы объясним, как она работает и как её использовать.

Что такое validate_username()?

Функция проверяет, является ли заданное имя пользователя допустимым. Допустимые символы включают:

• Латинские буквы (a-z, A-Z)
• Цифры (0-9)
• Символы: _ (нижнее подчеркивание), - (дефис), пробел и * (звездочка).

Используемая функция

Функция использует sanitize_user(), которая очищает имя пользователя, удаляя недопустимые символы.

Хуки функции

Функция имеет хуки для интеграции с другими частями WordPress:

• validate_username — используется для фильтрации результата проверки имени пользователя.

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

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

Как использовать validate_username()

Чтобы использовать эту функцию, необходимо передать ей строку с именем пользователя:

validate_username( $username );

где $username — строка, содержащая имя пользователя (обязательный параметр).

Примеры

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

Вот пример, как можно использовать функцию validate_username() для проверки имени пользователя и его регистрации:

В этом коде мы проверяем, подходит ли введённое имя пользователя, и существует ли оно уже в базе данных. Если всё в порядке, можно продолжать регистрацию.

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

Функция была добавлена в WordPress начиная с версии 2.0.1. Начиная с версии 4.4.0, пустые имена пользователей, которые были очищены, теперь считаются недопустимыми.

Код функции

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

function validate_username( $username ) {
$sanitized = sanitize_user( $username, true ); // Очищаем имя пользователя
$valid = ( $sanitized === $username && ! empty( $sanitized ) ); // Проверяем на валидность

/**
 * Фильтрует результат проверки имени пользователя.
 *
 * @since 2.0.1
 *
 * @param bool   $valid    Является ли имя пользователя допустимым.
 * @param string $username Имя пользователя для проверки.
 */
return apply_filters( 'validate_username', $valid, $username );

}

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

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

• auth_redirect() — редирект для авторизации.
• count_user_posts() — подсчет публикаций пользователя.
• email_exists() — проверка, существует ли электронная почта.
• username_exists() — проверка, существует ли имя пользователя.

Эти функции помогут вам управлять пользователями в вашем сайте на WordPress.

Теперь вы знаете, как использовать функцию validate_username() для проверки имен пользователей, что позволит вам улучшить функциональность вашего сайта на WordPress!