cache_purge_response_type

Директива cache_purge_response_type задаёт формат ответа для операций очистки кэша в NGINX.

Синтаксисcache_purge_response_type html | json | xml | text;
По умолчаниюhtml
Контекстhttp, server, location
Аргументы1

Описание

Директива cache_purge_response_type управляет типом содержимого ответов, формируемых при выполнении операции очистки кэша в NGINX Cache Purge module. Эта директива позволяет системным администраторам указать формат ответа, отправляемого клиентам после успешной очистки, что особенно полезно при интеграции с различными приложениями и API, которые могут ожидать разные типы содержимого. Доступные форматы включают HTML, JSON, XML и plain text, что обеспечивает гибкость в представлении результатов операций очистки для пользователей или систем.

По умолчанию директива установлена в 'html', что означает, что при успешной очистке кэша NGINX вернёт HTML-форматированный ответ, указывающий на успешное выполнение операции. При использовании этой директивы система автоматически генерирует тело ответа в соответствии с выбранным форматом. Например, выбор 'json' вернёт структурированный JSON-ответ, который может быть проще для обработки приложениями, работающими с форматами обмена данными. Выбор формата ответа может влиять на пользовательский опыт и интеграцию системы, что делает эту директиву полезной для настройки поведения очистки кэша.

Для применения этой директивы вы можете разместить её в контексте http, server или location в конфигурации NGINX, что даёт гибкость в зависимости от того, насколько детально вы хотите указывать тип ответа. Это позволяет эффективно обрабатывать разные типы содержимого или оперативные сценарии в вашей NGINX-развёртке.

Пример конфига

location /purge {
    cache_purge_response_type json;
    proxy_cache_purge my_cache $uri;
}

Если не задать эту директиву, это может привести к возврату стандартных HTML-ответов, которые не подходят для всех приложений.

Помните, что не все клиенты могут обрабатывать все типы ответов; обеспечьте совместимость с целевой аудиторией ответа.

← Ко всем директивам