Описание функции sanitize_term()
Функция sanitize_term() используется для очистки и валидации термина перед его сохранением в базе данных. Она гарантирует, что термин соответствует определенным стандартам и безопасен для использования в различных контекстах. Функция удаляет нежелательные символы и проверяет соответствие заданным условиям.
Эта функция часто используется при добавлении или обновлении терминов в таксономиях, таких как категории и теги.
Параметры
$term
Тип: string
Обязательный: Да
Описание: Название термина, который нужно очистить и валидировать
Возможные значения:
$taxonomy
Тип: string
Обязательный: Да
Описание: Имя таксономии, к которой относится термин
Возможные значения:
0: category
1: post_tag
2: custom_taxonomy
$slug
Тип: string
Обязательный: Нет
Описание: Слаг термина, если требуется его указание
Возможные значения:
Возвращаемое значение
Тип: string|false
Описание: Возвращает очищенную строку или false в случае ошибки
Возможные значения:
• Очищенная строка термина при успешной валидации
• false если термин пустой или невалидный
Примеры использования
Базовый пример очистки термина для категории
$clean_term = sanitize_term('Пример термина', 'category');
// $clean_term будет 'Пример термина'
Результат будет валидным и безопасным для использования
Очистка термина с указанием слага
$clean_term = sanitize_term('Тег_1', 'post_tag', 'tag_1');
// $clean_term будет 'Тег_1'
Слаг также будет обработан, если он указан
Пример обработки ошибки при передаче пустого термина
$clean_term = sanitize_term('', 'category');
// $clean_term будет false
Возвращается false, если термин невалидный
Безопасность
Валидация входных данных: Функция проверяет, что переданный термин не пустой и соответствует стандартам
Санитизация: Символы очищаются, чтобы предотвратить инъекции
Рекомендации: Используйте sanitize_term() перед сохранением терминов в базе данных
— Связанные функции
Добавляет новый термин в базу данных с автоматической очисткой
Обновляет существующий термин с очисткой
— Хуки
Позволяет модифицировать термины перед их очисткой
— Примечания
– Ограничения
Возвращает false для пустых или невалидных терминов
– Частые проблемы
- Ошибка при использовании специальных символов
- Необходимость проверки существования термина перед вызовом функции
