目录
当前位置: 首页 > 文档资料 > FuelPHP 中文文档 >

Agent 配置 - 类別

优质
小牛编辑
131浏览
2023-12-01

Agent 类别能让你撷取关于浏览器的类型、版本、平台或操作系统等基于客户使用者代理字串资讯。

配置

Agent 类别使用 PHP get_browser() 函式,它试图确定用户的浏览器的能力,在 browscap.ini 档案寻找浏览器的资讯。

以下全域的值可被定义:

参数类型预设描述
browscap阵列
array(
	'enabled' => true,
	'url'     => 'http://browsers.garykeith.com/stream.asp?BrowsCapINI',
	 'method' => 'wrapper',
	 'file'   => '/tmp/php_browscap.ini',
)
browscap.ini 取回配置。
cache阵列
array(
	'driver'     => '',
	'expiry'     => 604800,
	'identifier' => 'fuel.agent',
)
browscap.ini 快取配置。
Browscap.ini 配置

如果 PHP没有被配置为使用 browscap.ini 档案,Agent 类别将取回在 config/agent.php 配置中定义位置的档案,并在本地快取以再利用,此快取将定期更新, 根据配置中定义的逾时值。

参数类型预设描述
enabled布林
true
启用 browscap.ini 档案的下载,如果停用,且 PHP 没有被配置透过 get_browser() 的 browscap 功能,浏览器检测会停用,且 Agent 类别将回传 'unknown'。
method字串
'wrapper'
方法用于取回 browscap.ini 文件。支援的方法是:
  • 'wrapper':此方法使用 file_get_contents() 函式。这是首选方案,但它可能会被你的託管提供商禁用。
  • 'curl':此方法使用 curl 扩充。你可以在 'wrapper' 的方法不起作用时使用。
  • 'local':使用外部方法来下载 browscap.ini 文件(例如一个排程工作)。
  • 'sockets':留作将来使用
url字串
'http://browsers.garykeith.com/stream.asp?BrowsCapINI'
给 'wrapper'、'curl' 和 'sockets' 方法使用,要下载一个 browscap.ini 档案更新的路径。
file字串
'/tmp/php_browscap.ini'
给 'local' 方法使用,在本地储存系统的 browscap.ini 档案名称及位置。
快取配置

如果 Agent 类别被配置为处理 browscap.ini 档案,它将快取 ini 档案解析器和个人使用者代理请求的结果, 以增加类别的回应时间。这些配置设定确定资料如何被快取,更多资讯,请见 Cache 类别文件。

参数类型预设描述
driver字串
''
要快取代理资料的快取驱动程序,如果你留空,被配置在快取配置的预设快取驱动程序将被使用。
expiry整数
604800
直到快取资料过期的秒数,预设是 7 天,因为 browscap.ini 档案不常变更,建议不要一天刷新超过一次。
最小值设定是 7200 秒(两小时),如果你太常下载,你的伺服器将被 browscap 网站封锁!
identifier字串
'fuel.agent'
给快取名称的前缀。