catcoder/agent

Desktop/mobile user agent parser with support for Laravel, based on Mobiledetect

Wednesday, August 10, 2016
by catcoder
Repository
1 Watchers
1 Stars
8 Installations

PHP
0 Dependents
0 Suggesters
237 Forks
0 Open issues
20 Versions
0 % Grown

The README.md

Agent

, _(*1)

A PHP desktop/mobile user agent parser with support for Laravel, based on Mobile Detect with desktop support and additional functionality., _(*2)

, _(*3)

Installation

Install using composer:, _(*4)

composer require jenssegers/agent

Laravel (optional)

Add the service provider in app/config/app.php:, _(*5)

'Jenssegers\Agent\AgentServiceProvider',

And add the Agent alias to app/config/app.php:, _(*6)

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

Basic Usage

Start by creating an Agent instance (or use the Agent Facade if you are using Laravel):, _(*7)

use Jenssegers\Agent\Agent;

$agent = new Agent();

If you want to parse user agents other than the current request in CLI scripts for example, you can use the setUserAgent and setHttpHeaders methods:, _(*8)

$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);

All of the original Mobile Detect methods are still available, check out some original examples at https://github.com/serbanghita/Mobile-Detect/wiki/Code-examples, _(*9)

Is?

Check for a certain property in the user agent., _(*10)

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

Magic is-method

Magic method that does the same as the previous is() method:, _(*11)

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

Mobile detection

Check for mobile device:, _(*12)

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

Match user agent

Search the user agent with a regular expression:, _(*13)

$agent->match('regexp');

Additional Functionality

Accept languages

Get the browser's accept languages. Example:, _(*14)

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

Device name

Get the device name, if mobile. (iPhone, Nexus, AsusTablet, ...), _(*15)

$device = $agent->device();

Operating system name

Get the operating system. (Ubuntu, Windows, OS X, ...), _(*16)

$agent = $agent->platform();

Browser name

Get the browser name. (Chrome, IE, Safari, Firefox, ...), _(*17)

$browser = $agent->browser();

Desktop detection

Check if the user is using a desktop device., _(*18)

$agent->isDesktop();

This checks if a user is not a mobile device, tablet or robot., _(*19)

Phone detection

Check if the user is using a phone device., _(*20)

$agent->isPhone();

Robot detection

Check if the user is a robot., _(*21)

$agent->isRobot();

Robot name

Get the robot name. Note: this currently only works for major robots like Google, Facebook, Twitter, Bing, Baidu etc ..., _(*22)

$robot = $agent->robot();

Browser/platform version

MobileDetect recently added a version method that can get the version number for components. To get the browser or platform version you can use:, _(*23)

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

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

Note, the version method is still in beta, so it might not return the correct result., _(*24)

License

Laravel User Agent is licensed under The MIT License (MIT)., _(*25)

The Versions

10/08 2016

dev-master

9999999-dev https://github.com/catcoder/agent

Desktop/mobile user agent parser with support for Laravel, based on Mobiledetect

library agent

Desktop/mobile user agent parser with support for Laravel, based on Mobiledetect

catcoder/agent

The README.md

Agent

Installation

Laravel (optional)

Basic Usage

Is?

Magic is-method

Mobile detection

Match user agent

Additional Functionality

Accept languages

Device name

Operating system name

Browser name

Desktop detection

Phone detection

Robot detection

Robot name

Browser/platform version

License

The Versions

dev-master

The Requires

The Development Requires

by catcoder

v2.3.3

The Requires

The Development Requires

by Jens Segers

v2.3.2

The Requires

The Development Requires

by Jens Segers

v2.3.1

The Requires

The Development Requires

by Jens Segers

v2.3.0

The Requires

The Development Requires

by Jens Segers

v2.2.2

The Requires

The Development Requires

by Jens Segers

v2.2.1

The Requires

The Development Requires

by Jens Segers

v2.2.0

The Requires

The Development Requires

by Jens Segers

v2.1.7

The Requires

The Development Requires

by Jens Segers

v2.1.6

The Requires

The Development Requires

by Jens Segers

v2.1.5

The Requires

The Development Requires

by Jens Segers

v2.1.4

The Requires

The Development Requires

by Jens Segers

v2.1.3

The Requires

The Development Requires

by Jens Segers

v2.1.2

The Requires

The Development Requires

by Jens Segers