Описание функции delete_user_meta()
Функция delete_user_meta() используется для удаления метаданных, связанных с конкретным пользователем в WordPress. Она позволяет управлять пользовательскими данными, удаляя ненужные или устаревшие метаполя, что может быть полезно для оптимизации и поддержания базы данных.
Функция часто используется в плагинах и темах, когда необходимо очистить пользовательские данные или при изменении пользовательских настроек
Параметры
$user_id
Тип: int
Обязательный: Да
Описание: ID пользователя, для которого удаляется метаданные
Возможные значения:
$meta_key
Тип: string
Обязательный: Да
Описание: Ключ метаданных, которые нужно удалить
Возможные значения:
$meta_value
Тип: mixed
Обязательный: Нет
Описание: Значение метаданных для удаления (опционально). Если указано, удаляются только те метаданные, которые соответствуют этому значению
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true при успешном удалении метаданных, иначе false
Возможные значения:
• true — метаданные успешно удалены
• false — метаданные не найдены или не удалось удалить
Примеры использования
Базовый пример удаления метаданных пользователя с ID 1
$result = delete_user_meta(1, 'favorite_color');
// $result будет true, если метаданные удалены
Удаляет метаданные ‘favorite_color’
Удаление метаданных, если их значение соответствует ‘blue’
$result = delete_user_meta(1, 'favorite_color', 'blue');
// $result будет true, если метаданные с значением 'blue' удалены
Удалит только те метаданные, которые соответствуют значению ‘blue’
Обработка ситуации, когда метаданные не существуют
$result = delete_user_meta(999, 'non_existent_key');
if (!$result) {
echo 'Метаданные не найдены или не удалены';
}
Проверка успешного удаления
Безопасность
Валидация входных данных: Функция проверяет корректность ID пользователя и ключа метаданных
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Перед вызовом функции проверьте, что пользователь существует и что вы имеете соответствующие права
— Связанные функции
Добавляет метаданные пользователя
Получает метаданные пользователя
— Примечания
– Ограничения
Не удаляет метаданные, если они не существуют или ID пользователя некорректен
– Частые проблемы
- Ошибка при передаче неправильного ID пользователя
- Неудачное удаление, если метаданные не найдены
