A user agent class for Laravel

Installs: 159 961

Dependents: 8

Stars: 447

Watches: 25

Forks: 60

Open Issues: 4

Language: PHP

v2.1.7 2015-05-15 08:40 UTC

README

Latest Stable Version Total Downloads Build Status Coverage Status

A user agent class for Laravel, based on Mobile Detect with extended functionality.

Installation

Install using composer:

composer require jenssegers/agent

Add the service provider in app/config/app.php:

'Jenssegers\Agent\AgentServiceProvider',

And add the Agent alias to app/config/app.php:

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

Basic Usage

All of the original Mobile Detect functionality is still available, check out more examples over at https://github.com/serbanghita/Mobile-Detect/wiki/Code-examples

Is?

Check for a certain property in the user agent.

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:

Agent::isAndroidOS();
Agent::isNexus();
Agent::isSafari();

Mobile detection

Check for mobile device:

Agent::isMobile();
Agent::isTablet();

Match user agent

Search the user agent with a regular expression:

Agent::match('regexp');

Additional Functionality

Since the original library was inspired on CodeIgniter, I decided to add some additional functionality:

Accept languages

Get the browser's accept languages. Example:

$languages = Agent::languages();
// ['nl-nl', 'nl', 'en-us', 'en']

Device name

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

Agent::device();

Operating system name

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

Agent::platform();

Browser name

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

Agent::browser();

Desktop detection

Check if the user is a desktop.

Agent::isDesktop();

This checks if a user is not a mobile device, tablet or robot.

Robot detection

Check if the user is a robot.

Agent::isRobot();

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:

$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.

License

Laravel User Agent is licensed under The MIT License (MIT).