Описание функции wp_update_user()
Функция wp_update_user() обновляет информацию о пользователе в базе данных WordPress. Она позволяет изменять такие параметры, как имя, email, роль, пароль и другие метаданные пользователя.
Функция может использоваться как в админке, так и на пользовательских страницах, где требуется обновление данных пользователя
Параметры
$user
Тип: array|object|int
Обязательный: Да
По умолчанию: null
Описание: Идентификатор пользователя или массив данных для обновления
Возможные значения:
ID: ID пользователя (int)
user_email: Email пользователя (string)
display_name: Отображаемое имя (string)
user_pass: Пароль (string)
role: Роль пользователя (string)
Возвращаемое значение
Тип: int|WP_Error
Описание: ID обновленного пользователя или WP_Error в случае ошибки
Возможные значения:
• ID пользователя, если обновление прошло успешно
• WP_Error, если произошла ошибка
Примеры использования
Обновление email пользователя с ID 1
$result = wp_update_user(array(
'ID' => 1,
'user_email' => 'newemail@example.com'
));
// $result будет равен 1 при успешном обновлении
ID пользователя должен быть действительным
Обновление имени и роли пользователя
$result = wp_update_user(array(
'ID' => 2,
'display_name' => 'Новое имя',
'role' => 'editor'
));
Убедитесь, что роль существует
Проверка на ошибки при обновлении
$result = wp_update_user(array(
'ID' => 3,
'user_email' => 'invalid-email'
));
if (is_wp_error($result)) {
echo 'Ошибка: ' . $result->get_error_message();
}
Обработка ошибок с использованием is_wp_error
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: WordPress автоматически очищает входные данные
Рекомендации: Используйте capabilities для проверки прав пользователя перед обновлением данных
— Связанные функции
Вставляет нового пользователя в базу данных
Получает данные пользователя по ID или логину
— Примечания
– Ограничения
Не обновляет метаданные пользователя, только основные поля
– Частые проблемы
- Неверный ID пользователя
- Ошибка валидации email
