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