Agent 配置 - 类別

优质

小牛编辑

120浏览

2023-12-01

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

配置

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

以下全域的值可被定义：

参数类型预设描述

browscap

阵列

参数	类型	预设	描述
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 快取配置。

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'`	给快取名称的前缀。