orzcc / laravel-agent
支持Laravel的桌面/移动用户代理解析器,基于Mobiledetect
Requires
- php: >=5.4.0
- jaybizzle/crawler-detect: ^1.2
- mobiledetect/mobiledetectlib: ^2.7.6
Requires (Dev)
- phpunit/phpunit: ^4.0|^5.0|^6.0
- satooshi/php-coveralls: ^1.0
Suggests
- illuminate/support: ^4.0|^5.0
This package is auto-updated.
Last update: 2024-09-21 20:59:13 UTC
README
本包自用,新增了微信识别。如有常规需求,建议移步到 jenssegers/agent
这是一个支持Laravel的PHP桌面/移动用户代理解析器,基于Mobile Detect,并增加了桌面支持和额外功能。
安装
使用composer安装
composer require orzcc/laravel-agent
Laravel(可选)
在config/app.php
中添加服务提供者
Orzcc\Agent\AgentServiceProvider::class,
并将Agent别名添加到config/app.php
'Agent' => Orzcc\Agent\Facades\Agent::class,
基本用法
首先创建一个Agent
实例(或在Laravel中使用Agent
外观类)
use Orzcc\Agent\Agent; $agent = new Agent();
如果您想解析CLI脚本中当前请求以外的用户代理,可以使用setUserAgent
和setHttpHeaders
方法
$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'); $agent->is('WeChat'); $agent->is('QQ');
魔法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、...)
$platform = $agent->platform();
浏览器名称
获取浏览器名称。(Chrome、IE、Safari、Firefox、...)
$browser = $agent->browser();
桌面检测
检查用户是否使用桌面设备。
$agent->isDesktop();
这检查用户不是移动设备、平板电脑或机器人。
手机检测
检查用户是否使用手机设备。
$agent->isPhone();
机器人检测
检查用户是否是机器人。这使用jaybizzle/crawler-detect进行实际的机器人检测。
$agent->isRobot();
机器人名称
获取机器人名称。
$robot = $agent->robot();
浏览器/平台版本
MobileDetect最近添加了一个version
方法,可以获取组件的版本号。要获取浏览器或平台版本,可以使用
$browser = $agent->browser(); $version = $agent->version($browser); $platform = $agent->platform(); $version = $agent->version($platform);
注意,版本方法仍然处于测试阶段,因此可能不会返回正确的结果。
许可证
Laravel User Agent遵循MIT许可证(MIT)。