pckg_expires_index_gone

`pckg_expires_index_gone` 指令指定当请求的索引文件未找到时是否设置响应头。

语法pckg_expires_index_gone on | off;
默认值off
上下文http, server, location
参数1

说明

pckg_expires_index_gone 指令用于 Kaltura Media Framework 的 NGINX 模块,用来控制当请求过期的索引文件不存在时服务器的行为。启用(设置为 'on')时,该指令会发送一个表示索引已失效的响应,这有助于向客户端告知请求的资源不可用。对于媒体应用来说,这在索引文件缺失可能表示内容不再可访问时尤其有用。

该指令可在 httpserverlocation 上下文中使用,允许根据配置层级对其应用进行细粒度控制。设置该指令不仅会影响 HTTP 响应代码,还可以为客户端提供具体的处理指示,使其能够对缺失的资源做出适当响应。该指令接受的主要参数是布尔值,可方便地在启用和禁用状态之间切换。

需要注意的是,如果未设置此指令,NGINX 将采用其默认行为来处理不存在的索引文件,可能无法向客户端提供关于缺失资源的期望消息。正确配置 pckg_expires_index_gone 指令可以提升用户体验和应用可靠性。

配置示例

server {
    location /media/ {
        pckg_expires_index_gone on;
    }
}

确保该指令在正确的上下文(http、server、location)中设置,以便生效。

当 index file 被视为 'gone' 时,请在应用逻辑中适当地处理客户端响应。

在没有适当错误处理的情况下滥用此指令,可能会导致访问已过期内容的用户产生混淆。

← 返回所有指令