Agent 配置 - 类別
优质
小牛编辑
131浏览
2023-12-01
Agent 类别能让你撷取关于浏览器的类型、版本、平台或操作系统等基于客户使用者代理字串资讯。
配置
Agent 类别使用 PHP get_browser() 函式,它试图确定用户的浏览器的能力,在 browscap.ini 档案寻找浏览器的资讯。
以下全域的值可被定义:
参数 | 类型 | 预设 | 描述 |
---|---|---|---|
browscap | 阵列 |
| browscap.ini 取回配置。 |
cache | 阵列 |
| browscap.ini 快取配置。 |
Browscap.ini 配置
如果 PHP没有被配置为使用 browscap.ini 档案,Agent 类别将取回在 config/agent.php 配置中定义位置的档案,并在本地快取以再利用,此快取将定期更新, 根据配置中定义的逾时值。
参数 | 类型 | 预设 | 描述 |
---|---|---|---|
enabled | 布林 |
| 启用 browscap.ini 档案的下载,如果停用,且 PHP 没有被配置透过 get_browser() 的 browscap 功能,浏览器检测会停用,且 Agent 类别将回传 'unknown'。 |
method | 字串 |
| 方法用于取回 browscap.ini 文件。支援的方法是:
|
url | 字串 |
| 给 'wrapper'、'curl' 和 'sockets' 方法使用,要下载一个 browscap.ini 档案更新的路径。 |
file | 字串 |
| 给 'local' 方法使用,在本地储存系统的 browscap.ini 档案名称及位置。 |
快取配置
如果 Agent 类别被配置为处理 browscap.ini 档案,它将快取 ini 档案解析器和个人使用者代理请求的结果, 以增加类别的回应时间。这些配置设定确定资料如何被快取,更多资讯,请见 Cache 类别文件。
参数 | 类型 | 预设 | 描述 |
---|---|---|---|
driver | 字串 |
| 要快取代理资料的快取驱动程序,如果你留空,被配置在快取配置的预设快取驱动程序将被使用。 |
expiry | 整数 |
| 直到快取资料过期的秒数,预设是 7 天,因为 browscap.ini 档案不常变更,建议不要一天刷新超过一次。 最小值设定是 7200 秒(两小时),如果你太常下载,你的伺服器将被 browscap 网站封锁! |
identifier | 字串 |
| 给快取名称的前缀。 |