clear_request_cookie
在 NGINX 中,`clear_request_cookie` 指令从请求头中移除指定的 cookie。
Fine-grained request cookies control
·
httpserverlocation
语法clear_request_cookie cookie_name [if=condition];
默认值none
上下文http, server, location
参数1-2
说明
clear_request_cookie 指令在 NGINX 中用于有效地从请求头删除 cookie。当该指令被调用时,会按名称检查指定的 cookie 是否存在。如果请求中存在该 cookie,则将其移除;如果不存在,则不执行任何操作。此操作有助于管理哪些 cookie 会被发送到后端应用,尤其是在根据应用或用户的特定逻辑不应将某些 cookie 转发的场景中。
该指令可用于 http、server 或 location 上下文,并可接受一个可选参数以有条件地执行清除操作。这意味着你可以指定一个必须为真的 if 条件来清除 cookie,从而对请求处理进行精细控制。该指令最多可接受两个参数:第一个为要清除的 cookie 名称,可选的第二个为条件。
配置示例
location / {
clear_request_cookie session_id;
clear_request_cookie auth_token if=$http_a;
}⚠
不正确地使用条件可能会导致意外行为,例如在本应清除 cookie 时未被清除。
⚠
请确保 cookie 名称拼写正确且区分大小写,因为 cookie 名称是大小写敏感的。