## EMAIL_EXISTS() ─ Проверка наличия email в WP 2.1.0
Функция email_exists() проверяет, существует ли указанный email в системе. Это полезно, например, при регистрации пользователей, чтобы удостовериться, что введенный адрес электронной почты не занят другим пользователем.
### Возвращаемые значения
- **int|false**: Если email существует, вернется идентификатор пользователя (user ID). Если email не найден, будет возвращено значение false.
### Использование функции
```php
$email_exists = email_exists( $email );
- $email (string) (обязательный): адрес электронной почты, который необходимо проверить на наличие в системе.
Пример использования
1. Проверка email при регистрации пользователя
В этом примере, если email уже занят, будет выведен идентификатор пользователя, к которому он относится. Если email свободен, появится сообщение о том, что данный адрес можно использовать для регистрации.
$email = '[email protected]';
$email_exists = email_exists( $email );
if( $email_exists ){
echo "Этот email зарегистрирован под пользователем с ID: {$email_exists}";
} else {
echo 'Вы можете использовать этот email для регистрации, он не принадлежит ни одному пользователю';
}
Изменения в коде
С момента появления функции в версии 2.1.0 были внесены обновления в код. Ниже представлен код функции email_exists().
function email_exists( $email ) {
$user = get_user_by( 'email', $email );
if ( $user ) {
$user_id = $user->ID;
} else {
$user_id = false;
}
/**
* Фильтрует проверку наличия указанного email.
*
* @since 5.6.0
*
* @param int|false $user_id Идентификатор пользователя, связанный с email,
* или false, если email не существует.
* @param string $email Email для проверки.
*/
return apply_filters( 'email_exists', $user_id, $email );
}
Связанные функции
Функция email_exists() относится к категории условных тегов. Вот некоторые другие функции, которые могут вам помочь:
username_exists(): Проверяет, существует ли указанный логин.post_exists(): Проверяет, существует ли указанный пост.term_exists(): Проверяет, существует ли указанный термин.
Эти функции помогут вам выполнять дополнительные проверки на вашем сайте WordPress.
Пожалуйста, дайте знать, если есть необходимость в дополнительных правках или уточнениях!