這些模組預設會全部編譯進Nginx,除非手工指定某個模組在configure時排除。
模組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。