Описание функции get_query_var()
Функция get_query_var() используется для получения значений переменных запроса, которые передаются через URL. Она позволяет извлекать данные, такие как метки, типы записей и другие параметры запроса, что делает ее важной для работы с пользовательскими запросами и построением динамического контента.
Функция часто используется в темах и плагинах для обработки пользовательских запросов и настройки вывода данных
Параметры
$query_var
Тип: string
Обязательный: Да
По умолчанию: null
Описание: Имя переменной запроса, значение которой необходимо получить
Возможные значения:
0: category_name
1: post_type
2: paged
3: custom_var
Возвращаемое значение
Тип: mixed
Описание: Значение запрашиваемой переменной или null, если переменная не найдена
Возможные значения:
• Строка с значением переменной запроса
• Число, если переменная представляет числовое значение
• null, если переменная не определена
Примеры использования
Базовый пример получения имени категории из запроса
$category_name = get_query_var('category_name');
// Выводим имя категории
echo $category_name;
Должен быть доступен в URL, например, ?category_name=news
Получение номера текущей страницы для пагинации
$paged = get_query_var('paged');
// Выводим номер текущей страницы
echo $paged;
Полезно для настройки пагинации в цикле записей
Безопасность
Валидация входных данных: Функция проверяет наличие переменной перед возвратом значения
Санитизация: Входные данные автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для предотвращения XSS
— Связанные функции
Устанавливает значение переменной запроса
Получает шаблон для текущего запроса
— Хуки
Фильтрует список доступных переменных запроса
— Примечания
– Ограничения
Возвращает только переменные запроса, которые были установлены
– Частые проблемы
- Возвращает null, если переменная не существует в запросе
- Ошибки при неправильном использовании имен переменных
