Apache HTTP Server 版本 2.4
描述 | 点击流 记录网站上用户活动的日志 |
---|---|
状态 | 扩展 |
模块标识符 | usertrack_module |
源文件 | mod_usertrack.c |
通过浏览器 cookie 提供对用户在您网站上的跟踪。
mod_usertrack
设置一个 cookie,可以通过 mod_log_config
可配置的日志记录格式进行记录
LogFormat "%{Apache}n %r %t" usertrack CustomLog "logs/clickstream.log" usertrack
描述 | 跟踪 cookie 适用的域 |
---|---|
语法 | CookieDomain domain |
上下文 | 服务器配置、虚拟主机、目录、.htaccess |
覆盖 | FileInfo |
状态 | 扩展 |
模块 | mod_usertrack |
此指令控制设置跟踪 cookie 适用的域。如果不存在,则 cookie 标头字段中不包含任何域。
域字符串必须以点开头,并且必须包含至少一个嵌入的点。也就是说,.example.com
是合法的,但 www.example.com
和 .com
不是。
.co.uk
)设置 cookie,尽管这样的域表面上满足了上述要求。.com
),允许此类 cookie 可能会存在安全风险。因此,如果您位于两部分顶级域下,您仍然应该使用您的实际域,就像您对任何其他顶级域一样(例如 .example.co.uk
)。CookieDomain .example.com
描述 | 跟踪 cookie 的过期时间 |
---|---|
语法 | CookieExpires expiry-period |
上下文 | 服务器配置、虚拟主机、目录、.htaccess |
覆盖 | FileInfo |
状态 | 扩展 |
模块 | mod_usertrack |
使用时,此指令会为 usertrack 模块生成的 cookie 设置过期时间。expiry-period 可以以秒数给出,也可以以“2 周 3 天 7 小时”之类的格式给出。有效单位是:年、月、周、天、小时、分钟和秒。如果过期时间不是以表示秒数的一个数字以外的任何格式给出,则必须用双引号括起来。
如果未使用此指令,cookie 仅在当前浏览器会话期间有效。
CookieExpires "3 weeks"
描述 | 向 cookie 添加“HTTPOnly”属性 |
---|---|
语法 | CookieHTTPOnly on|off |
默认值 | CookieHTTPOnly off |
上下文 | 服务器配置、虚拟主机、目录、.htaccess |
覆盖 | FileInfo |
状态 | 扩展 |
模块 | mod_usertrack |
兼容性 | 2.4.42 及更高版本 |
设置为“ON”时,将“HTTPOnly”cookie 属性添加到此模块的跟踪 cookie 中。此属性指示浏览器阻止 javascript 读取 cookie 的值。
描述 | 跟踪 cookie 的名称 |
---|---|
语法 | CookieName token |
默认值 | CookieName Apache |
上下文 | 服务器配置、虚拟主机、目录、.htaccess |
覆盖 | FileInfo |
状态 | 扩展 |
模块 | mod_usertrack |
此指令允许您更改此模块用于跟踪目的的 cookie 的名称。默认情况下,cookie 的名称为“Apache
”。
您必须指定一个有效的 cookie 名称;如果您使用包含非正常字符的名称,结果将不可预测。有效字符包括 A-Z、a-z、0-9、“_”和“-”。
CookieName clicktrack
描述 | 向 cookie 添加“SameSite”属性 |
---|---|
语法 | CookieSameSite None|Lax|Strict |
默认值 | 未设置 |
上下文 | 服务器配置、虚拟主机、目录、.htaccess |
覆盖 | FileInfo |
状态 | 扩展 |
模块 | mod_usertrack |
兼容性 | 2.4.42 及更高版本 |
设置为“None”、“Lax”或“Strict”时,将“SameSite”cookie 属性添加到此模块的跟踪 cookie 中,并使用相应的 value。此属性指示浏览器在跨站点上下文中请求 cookie 时如何处理 cookie。
值为“None”会设置“SameSite=None”,这是最宽松的设置。要省略此属性,请完全省略此指令。
描述 | 向 cookie 添加“Secure”属性 |
---|---|
语法 | CookieSecure on|off |
默认值 | CookieSecure off |
上下文 | 服务器配置、虚拟主机、目录、.htaccess |
覆盖 | FileInfo |
状态 | 扩展 |
模块 | mod_usertrack |
兼容性 | 2.4.42 及更高版本 |
设置为“ON”时,将“Secure”cookie 属性添加到此模块的跟踪 cookie 中。此属性指示浏览器仅通过 HTTPS 传输 cookie。
描述 | cookie 标头字段的格式 |
---|---|
语法 | CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 |
默认值 | CookieStyle Netscape |
上下文 | 服务器配置、虚拟主机、目录、.htaccess |
覆盖 | FileInfo |
状态 | 扩展 |
模块 | mod_usertrack |
此指令控制 cookie 标头字段的格式。允许的三种格式是
并非所有客户端都能理解所有这些格式,但您应该使用最适合用户浏览器的一般接受的最新格式。在撰写本文时,大多数浏览器都支持这三种格式,其中 Cookie2
是首选格式。
CookieStyle Cookie2
描述 | 启用跟踪 cookie |
---|---|
语法 | CookieTracking on|off |
默认值 | CookieTracking off |
上下文 | 服务器配置、虚拟主机、目录、.htaccess |
覆盖 | FileInfo |
状态 | 扩展 |
模块 | mod_usertrack |
加载 mod_usertrack
时,如果设置了 CookieTracking on
,Apache 将为所有新请求发送用户跟踪 cookie。此指令可用于在每个服务器或每个目录的基础上打开或关闭此行为。默认情况下,启用 mod_usertrack
不会激活 cookie。
CookieTracking on