Описание функции sanitize_title()
Функция sanitize_title() очищает и нормализует строку, чтобы сделать ее безопасной для использования в URL. Она удаляет специальные символы, заменяет пробелы на дефисы и приводит строку к нижнему регистру.
Эта функция часто используется при создании постоянных ссылок на записи, страницы и другие пользовательские объекты в WordPress.
Параметры
$title
Тип: string
Обязательный: Да
Описание: Строка, которую необходимо очистить и нормализовать
Возможные значения:
$raw
Тип: bool
Обязательный: Нет
Описание: Указывает, является ли строка сырой (необработанной) или нет
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: string
Описание: Очищенная и нормализованная строка, готовая для использования в URL
Возможные значения:
• Строка, содержащая только разрешенные символы
• Пустая строка, если входные данные не содержат символов для преобразования
Примеры использования
Очистка обычного заголовка для использования в URL
$slug = sanitize_title('Привет мир!');
// $slug будет 'privet-mir'
Результат: ‘privet-mir’
Очистка заголовка с указанием, что строка может быть сырой
$slug = sanitize_title('Заголовок записи #1', true);
// $slug будет 'zagolovok-zapisi-1'
Результат: ‘zagolovok-zapisi-1’
Безопасность
Валидация входных данных: Функция проверяет, что входные данные являются строкой
Санитизация: Все входные параметры проходят через обработку для удаления нежелательных символов
Рекомендации: Рекомендуется использовать sanitize_title() перед использованием строк в URL
— Связанные функции
Удаляет нежелательные символы из текстовых полей
Создает slug из строки для использования в URL
— Хуки
Фильтрует очищенный заголовок перед его возвращением
— Примечания
– Ограничения
Может не обрабатывать некоторые специальные символы в зависимости от настроек
– Частые проблемы
- Возвращение пустой строки, если входные данные пустые или содержат только специальные символы
- Некорректное преобразование заголовков с нестандартными символами
