User ID模块（User ID）

回目录

·摘要

模块ngx_http_userid_module为连接发布cookie，主要使用$uid_got和$uid_set变量，注意：$uid_got无法$uid_set在SSI中取得，因为SSI过滤模块工作在userid模块过滤之前。
这个模块相当于Apache的mod_uid模块。
示例配置：

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

语法：userid [on|v1|log||off]
默认值：userid off
使用字段：http, server, location
是否启用发出cookie或者记录到被请求的cookie：

·on - 启用版本2的cookie并记录。
·v1 - 启用版本1的cookie并记录。
·log - 不传送cookie，但是写入日志。
·off - 禁用cookie。

userid_domain

语法：userid_domain [ name | none ]
默认值：userid_domain none
使用字段：http, server, location
指定cookie的域名，参数“none”不对任何域名发出cookie。

userid_expires

语法：userid_expires [ time | max ]
默认值：none
使用字段：http, server, location
设置cookie的过期时间。
参数设置并发出浏览器对于cookie的实效时间，值“max”指定过期时间为：2037年12月31日23:55:55 GMT，这是某些旧浏览器所能识别的最大时间。

userid_name

语法：userid_name name
默认值：userid_name uid
使用字段：http, server, location
设置cookie的名称。

userid_p3p

语法：userid_p3p line
默认值：none
使用字段：http, server, location
为和cookie一起传递的P3P头指定一个值。

userid_path

语法：userid_path path
默认值：userid_path /
使用字段：http, server, location
设置cookie路径。

userid_service

语法：userid_service number
默认值：userid_service address
使用字段：http, server, location
设置cookie发布的服务器地址，如果不设置，版本一的cookie将其设置为0，版本二将其设置为服务器IP。

·参考文档

Original Documentation
Nginx Http User ID Module

前进->可选HTTP模块