catcoder/agent

支持Laravel的桌面/移动用户代理解析器,基于Mobiledetect

v2.3.3 2016-03-08 13:47 UTC

README

Latest Stable Version Total Downloads Build Status Coverage Status Donate

A PHP桌面/移动用户代理解析器,支持Laravel,基于Mobile Detect,具有桌面支持和其他功能。

安装

使用composer安装

composer require jenssegers/agent

Laravel(可选)

app/config/app.php中添加服务提供者

'Jenssegers\Agent\AgentServiceProvider',

并将Agent别名添加到app/config/app.php

'Agent' => 'Jenssegers\Agent\Facades\Agent',

基本用法

首先创建一个Agent实例(如果你使用Laravel,可以使用Agent外观)

use Jenssegers\Agent\Agent;

$agent = new Agent();

如果你想解析CLI脚本中除当前请求之外的用户代理,可以使用setUserAgentsetHttpHeaders方法

$agent->setUserAgent('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/537.13+ (KHTML, like Gecko) Version/5.1.7 Safari/534.57.2');
$agent->setHttpHeaders($headers);

所有的原始Mobile Detect方法仍然可用,请查看一些原始示例https://github.com/serbanghita/Mobile-Detect/wiki/Code-examples

是?

检查用户代理中的特定属性。

$agent->is('Windows');
$agent->is('Firefox');
$agent->is('iPhone');
$agent->is('OS X');

魔术is方法

与之前的is()方法相同的功能魔术方法

$agent->isAndroidOS();
$agent->isNexus();
$agent->isSafari();

移动检测

检查移动设备

$agent->isMobile();
$agent->isTablet();

匹配用户代理

使用正则表达式搜索用户代理

$agent->match('regexp');

附加功能

接受语言

获取浏览器的接受语言。示例

$languages = $agent->languages();
// ['nl-nl', 'nl', 'en-us', 'en']

设备名称

获取设备名称,如果是移动设备。(iPhone,Nexus,AsusTablet等)

$device = $agent->device();

操作系统名称

获取操作系统。(Ubuntu,Windows,OS X等)

$agent = $agent->platform();

浏览器名称

获取浏览器名称。(Chrome,IE,Safari,Firefox等)

$browser = $agent->browser();

桌面检测

检查用户是否使用桌面设备。

$agent->isDesktop();

这检查用户不是移动设备、平板电脑或机器人。

电话检测

检查用户是否使用电话设备。

$agent->isPhone();

机器人检测

检查用户是否是机器人。

$agent->isRobot();

机器人名称

获取机器人名称。注意:目前这仅适用于主要机器人,如Google,Facebook,Twitter,Bing,Baidu等...

$robot = $agent->robot();

浏览器/平台版本

MobileDetect最近添加了一个version方法,可以获取组件的版本号。要获取浏览器或平台版本,可以使用

$browser = $agent->browser();
$version = $agent->version($browser);

$platform = $agent->platform();
$version = $agent->version($platform);

注意,版本方法仍然处于beta测试阶段,因此可能不会返回正确的结果。

许可证

Laravel User Agent采用MIT许可证(MIT)