php封装一个useragent包


0x01.JueUserAgent

JueUserAgent 是一个为http://jue.so 而写的php包.

主要用于获取用户浏览器代理信息,用户referrer,设备,版本等。

JueUserAgent主要解析$_SERVER,分析http报头信息。

Fork me here: http://77l5jp.com1.z0.glb.clouddn.com/blog%2FUserAgent.zip




0x02.关于http报头

关于http报头详细请看这里:     《小草浅浅谈web二》

利用php魔术变量$_SERVER得到:

$_SERVER获取http报头

于是找到相关教程,抄了一大段:http://www.5idev.com/p-php_server.shtml

页面程序相关

$_SERVER['PHP_SELF']:相对于网站根目录的路径及 PHP 程序名称,与 document root 相关。
$_SERVER['HTTP_REFERER']:链接到当前页面的前一页面的 URL 地址。
$_SERVER['SCRIPT_NAME']:相对于网站根目录的路径及 PHP 程序文件名称 。
$_SERVER['REQUEST_URI']:访问此页面所需的 URI 。
$_SERVER['SCRIPT_FILENAME']:当前运行 PHP 程序的绝对路径及文件名。
$_SERVER['PATH_TRANSLATED']:当前 PHP 程序所在文件系统(不是文档根目录)的基本路径。
$_SERVER['QUERY_STRING']:查询(query)的字符串(URL 中第一个问号 ? 之后的内容但不包括 # 后面的内容)。
$_SERVER['argv']:传递给当前 PHP 程序的参数。
$_SERVER['argc']:命令行模式下,包含传递给程序的命令行参数的个数。
$_SERVER['REQUEST_TIME']:请求开始时的时间戳,从 PHP 5.1.0 起有效。
$_SERVER['REQUEST_METHOD']:访问页面时的请求方法,例如:“GET”、“HEAD”,“POST”或“PUT”。
$_SERVER['HTTP_ACCEPT']:当前请求的 Accept: 头信息的内容。
$_SERVER['HTTP_ACCEPT_CHARSET']:当前请求的 Accept-Charset: 头信息的内容。例如:“iso-8859-1,*,utf-8”。
$_SERVER['HTTP_ACCEPT_ENCODING']:当前请求的 Accept-Encoding: 头信息的内容。例如:“gzip”。
$_SERVER['HTTP_ACCEPT_LANGUAGE']:当前请求的 Accept-Language: 头信息的内容。例如:“zh-cn”。
$_SERVER['HTTP_CONNECTION']:当前请求的 Connection: 头信息的内容。例如:“Keep-Alive”。
$_SERVER['HTTP_HOST']:当前请求的 Host: 头信息的内容。
$_SERVER['HTTPS']:如果 PHP 程序是通过 HTTPS 协议被访问,则被设为一个非空的值。
$_SERVER['PHP_AUTH_DIGEST']:当作为 Apache 模块运行时,进行 HTTP Digest 认证的过程中,此变量被设置成客户端发送的“Authorization”HTTP 头内容(以便作进一步的认证操作)。
$_SERVER['PHP_AUTH_USER']:当 PHP 运行在 Apache 或 IIS(PHP 5 是 ISAPI)模块方式下,并且正在使用 HTTP 认证功能,这个变量便是用户输入的用户名。
$_SERVER['PHP_AUTH_PW']:当 PHP 运行在 Apache 或 IIS(PHP 5 是 ISAPI)模块方式下,并且正在使用 HTTP 认证功能,这个变量便是用户输入的密码。
$_SERVER['AUTH_TYPE']:当 PHP 运行在 Apache 模块方式下,并且正在使用 HTTP 认证功能,这个变量便是认证的类型。

服务器端相关

$_SERVER['DOCUMENT_ROOT']:当前运行 PHP 程序所在的文档根目录,在服务器配置文件中定义。
$_SERVER['GATEWAY_INTERFACE']:服务器使用的 CGI 规范的版本,例如:“CGI/1.1”。
$_SERVER['SERVER_ADDR']:当前运行 PHP 程序所在的服务器的 IP 地址。
$_SERVER['SERVER_NAME']:当前运行 PHP 程序所在的服务器的名称。
$_SERVER['SERVER_ADMIN']:Apache 服务器配置文件中的 SERVER_ADMIN 参数。
$_SERVER['SERVER_PORT']:服务器所使用的端口。如果使用 SSL 安全连接,则这个值为用户设置的 HTTP 端口。
$_SERVER['SERVER_SIGNATURE']:包含服务器版本和虚拟主机名的字符串。
$_SERVER['SERVER_SOFTWARE']:服务器标识的字串,在响应请求时的头信息中给出。
$_SERVER['SERVER_PROTOCOL']:请求页面时通信协议的名称和版本,例如:“HTTP/1.0”。

其他杂项

$_SERVER['HTTP_USER_AGENT']:当前请求的 User-Agent: 头信息的内容,该字符串表明了访问该页面的用户代理的信息。
$_SERVER['REMOTE_ADDR']:正在浏览当前页面用户的 IP 地址。
$_SERVER['REMOTE_HOST']:正在浏览当前页面用户的主机名。
$_SERVER['REMOTE_PORT']:用户连接到服务器时所使用的端口。

注意,如果以命令行方式运行 PHP,上面列出的元素几乎没有有效的(或是没有任何实际意义的)




0x03 使用教程(api)

初始化:

$jue = new JueAgent();

当JueUserAgent 类初始化后,它会判断浏览你的网站是Web浏览器,还是移动设备,还是机器人。

if ($jue->is_browser()) {
    $agent = $jue->browser().' '.$jue->version();
} elseif ($jue->is_robot()) {
    $agent = $jue->robot();
} elseif ($jue->is_mobile()) {
    $agent = $jue->mobile();
} else {
    $agent = 'Unidentified User Agent';
}

echo $agent;

echo $jue->platform(); // Platform info (Windows, Linux, Mac, etc.)

函数参考:

$jue->is_browser();

根据用户代理是否是一个已知的web浏览器,返回 TRUE/FALSE (boolean)

if ($jue->is_browser('Safari')) {
    echo 'You are using Safari.';
} else if ($jue->is_browser()) {
    echo 'You are using a browser.';
}

Note: 字符串 “Safari”是已定义的浏览器列表的数组键,如果您想添加新的浏览器,可以修改config.php。

$jue->is_mobile()

根据用户代理是否是一个已知的移动设备,返回 TRUE/FALSE (boolean)

if ($jue->is_mobile('iphone')) {
    $this->load->view('iphone/home');
} else if ($jue->is_mobile()) {
    $this->load->view('mobile/home');
} else {
    $this->load->view('web/home');
}

$jue->is_robot()

根据用户代理是否是机器人,返回 TRUE/FALSE (boolean)

注意:  用户代理类仅包含了最常见的机器人定义。它不是一个完整的机器人清单。如果你觉得有些经常访问你的网站的机器人不在名单中,你可以将它们添加到你的.lib/config.php 文件中.

$jue->is_referral()

根据用户代理是否是从另一网站链接过来,返回 TRUE/FALSE (boolean)

$jue->browser()

返回一个字符串,就是浏览你的网站的浏览器名称

$jue->version()

返回浏览器的版本号

$jue->mobile()

返回访问你的站点的移动设备名称

$jue->robot()

返回访问你的站点的机器人名称

$jue->platform()

返回访问你的站点的操作系统(Linux, Windows, OS X, 等等).

$jue->referrer()

如果用户代理是从其他站点链接过来的,你可以做如下判断

if ($jue->is_referral()) {
    echo $jue->referrer();
}

$jue->agent_string()

返回一个字符串包含所有用户代理信息。通常它会是这样的:

Mozilla/5.0 (Macintosh; U; Intel Mac OS X; en-US; rv:1.8.0.4) Gecko/20060613 Camino/1.0.2

$jue->accept_lang()

让你确认,用户代理是否包含一种特定的语言。例:

if ($jue->accept_lang('en')) {
    echo 'You accept English!';
}

注意: 这一功能通常不是很可靠,因为有些浏览器不提供语言信息,即使提供了,也不一定准确

$jue->accept_charset()

让你确认,用户代理是否包含一种特定的字符集。例:

if ($jue->accept_charset('utf-8')) {
    echo 'You browser supports UTF-8!';
}




本文出处 夏日小草, 转载请注明出处: http://homeway.me/2014/06/21/php-package-for-useragent/


-By 小草

2014-06-21 10:32:33

Fork me on GitHub