用户 ID#
模块设置适合客户端识别的 cookies。接收到的和设置的 cookies 可以使用内置变量 $uid_got 和 $uid_set 进行记录。该模块与 Apache 的 mod_uid 模块兼容。 启用或禁用设置 cookies 和记录接收到的 cookies: 启用设置版本 2 的 cookies 和记录接收到的 cookies; 启用设置版本 1 的 cookies 和记录接收到的 cookies; 禁用设置 cookies,但启用记录接收到的 cookies; 禁用设置 cookies 和记录接收到的 cookies。 定义设置 cookies 的域。参数 设置浏览器应保持 cookies 的时间。参数 max 会导致 cookie 在“2037年12月31日 23:55:55 GMT”过期。参数 如果参数不是 如果参数不是 如果设置了标记,则将其与传递在 cookie 中的客户端标识符的 base64 表示的第一个填充符号进行比较。如果它们不匹配,则会使用指定的标记、过期时间和“P3P”头重新发送 cookie。 默认值 http, server, location 设置 cookie 名称。 设置将与 cookie 一起发送的“P3P”头字段的值。如果指令设置为特殊值 定义设置 cookies 的路径。 如果由多个服务器(服务)发出标识符,则应为每个服务分配其自己的 cookie 名称和接收到的客户端标识符。 如果变量设置为非空字符串且不是 cookie 名称和发送的客户端标识符。配置示例#
userid on;
userid_name uid;
userid_domain example.com;
userid_path /;
userid_expires 365d;
userid_p3p 'policyref="/w3c/p3p.xml", CP="CUR ADM OUR NOR STA NID"';
指令#
userid#
on
v1
log
off
userid_domain#
none
禁用设置 cookies 的域。userid_expires#
off
会导致 cookie 在浏览器会话结束时过期。userid_flags#
off
,则定义一个或多个 cookies 的附加标志: secure
, httponly
, samesite=strict
, samesite=lax
, samesite=none
。userid_mark#
off
,则启用 cookie 标记机制并设置用作标记的字符。该机制用于在保持客户端标识符的同时添加或更改 userid_p3p 和/或 cookies 过期时间。标记可以是任何英文字母(区分大小写)、数字或“=”字符。userid_name#
userid_name
name;userid_name uid;
userid_p3p#
none
,则在响应中将不发送“P3P”头。userid_path#
userid_service#
number
以确保客户端标识符的唯一性。对于版本 1 的 cookies,默认值为零。对于版本 2 的 cookies,默认值为由服务器的 IP 地址的最后四个八位字节组成的数字。内置变量#
$uid_got
#$uid_reset
#0
,则客户端标识符将被重置。特殊值 log
还会导致关于重置标识符的消息输出到 error_log。$uid_set
#