cache_purge_response_type
cache_purge_response_type 指令用于在 NGINX 中设置缓存清除操作的响应格式。
NGINX Cache Purge module
·
httpserverlocation
语法cache_purge_response_type html | json | xml | text;
默认值html
上下文http, server, location
参数1
说明
cache_purge_response_type 指令控制 NGINX Cache Purge 模块在执行缓存清除操作时生成的响应的内容类型。该指令允许系统管理员指定清除成功后发送给客户端的响应格式，这对于与可能期望不同内容类型的各种应用程序和 API 集成尤其有用。可用格式包括 HTML、JSON、XML 和纯文本，使得向用户或系统展示清除操作的方式具有灵活性。
默认情况下，该指令被设置为 'html'，这意味着在缓存清除成功时，NGINX 将返回一个以 HTML 格式表示操作成功的响应。使用该指令时，系统会根据所选格式自动生成响应主体。例如，选择 'json' 将返回结构化的 JSON 响应，这对于以数据交换格式工作的应用程序更易于处理。响应格式的选择会影响用户体验和系统集成，因此该指令对于定制缓存清除的行为非常有价值。
要应用该指令，可以将其放置在 NGINX 配置中的 http、server 或 location 上下文中，这取决于你希望响应类型指定的粒度，从而提供灵活性。这使得你能够在 NGINX 部署中有效地处理不同类型的内容或操作场景。
配置示例
location /purge {
cache_purge_response_type json;
proxy_cache_purge my_cache $uri;
}⚠
未设置此指令可能会导致默认的 HTML 响应，而这些响应可能并不适用于所有应用程序。
⚠
请记住，并非所有客户端都能处理每种响应类型；请确保响应与预期受众兼容。