clear_request_cookie

在 NGINX 中,`clear_request_cookie` 指令从请求头中移除指定的 cookie。

语法clear_request_cookie cookie_name [if=condition];
默认值none
上下文http, server, location
参数1-2

说明

clear_request_cookie 指令在 NGINX 中用于有效地从请求头删除 cookie。当该指令被调用时,会按名称检查指定的 cookie 是否存在。如果请求中存在该 cookie,则将其移除;如果不存在,则不执行任何操作。此操作有助于管理哪些 cookie 会被发送到后端应用,尤其是在根据应用或用户的特定逻辑不应将某些 cookie 转发的场景中。

该指令可用于 httpserverlocation 上下文,并可接受一个可选参数以有条件地执行清除操作。这意味着你可以指定一个必须为真的 if 条件来清除 cookie,从而对请求处理进行精细控制。该指令最多可接受两个参数:第一个为要清除的 cookie 名称,可选的第二个为条件。

配置示例

location / {
    clear_request_cookie session_id; 
    clear_request_cookie auth_token if=$http_a;
}

不正确地使用条件可能会导致意外行为,例如在本应清除 cookie 时未被清除。

请确保 cookie 名称拼写正确且区分大小写,因为 cookie 名称是大小写敏感的。

← 返回所有指令