Описание функции get_userdata()
Функция get_userdata() возвращает информацию о пользователе по его ID. Она используется для получения данных пользователя, таких как имя, email, роль и другие метаданные. Эта функция полезна в темах и плагинах, когда необходимо отображать или обрабатывать данные конкретного пользователя.
Результат возвращается в виде объекта WP_User, что упрощает доступ к его свойствам и методам.
Параметры
$user_id
Тип: int
Обязательный: Да
По умолчанию: none
Описание: ID пользователя, информацию о котором необходимо получить
Возможные значения:
Возвращаемое значение
Тип: WP_User|false
Описание: Объект WP_User с информацией о пользователе или false в случае ошибки
Возможные значения:
• Объект WP_User при успешном выполнении
• false, если пользователь не найден или произошла ошибка
Примеры использования
Базовый пример получения данных пользователя с ID 1
$user = get_userdata(1);
if ($user) {
echo $user->display_name;
}
Вывод имени пользователя
Получение email пользователя и обработка случая, когда пользователь не найден
$user = get_userdata(999);
if ($user) {
echo $user->user_email;
} else {
echo 'Пользователь не найден';
}
Обработка ошибки
Безопасность
Валидация входных данных: Функция проверяет, что переданный ID является положительным целым числом
Санитизация: Данные, возвращаемые пользователем, автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для безопасного отображения информации о пользователе
— Связанные функции
Получает данные текущего пользователя
Получает информацию о пользователе по логину, email или другим полям
— Хуки
Фильтрует объект WP_User перед его возвратом
— Примечания
– Ограничения
Функция возвращает только информацию о существующих пользователях
– Частые проблемы
- false при неверном ID пользователя
- Ошибка при обращении к свойствам, если пользователь не найден
