01-local-providers.md

Local providers

A detailed description of all local providers

• BrowscapPhp
• DonatjUAParser
• PiwikDeviceDetector
• SinergiBrowserDetector
• UAParser
• WhichBrowser
• Woothee

BrowscapPhp

Is a provider which exists now for a really long time. The data is also used in the PHP core function get_browser() (which is really slow)

To get this provider working, you need todo some work before. There are multiple ways to install this provider and update / cache it.

If you want another method then described here, please see the official documentation here

• other cache types available
• directly download and update the data file
• ...

Install

composer require browscap/browscap-php 

Download browscap.ini

Go to http://browscap.org/ and get the latest download for PHP You can take full or lite. Both should work.

Warmup the cache

We assume that you have put the downloaded file to data/full_php_browscap.ini

use BrowscapPHP\Browscap;
use BrowscapPHP\Helper\IniLoader;
use WurflCache\Adapter\File;

/*
 * Browscap cache init
 */
include 'bootstrap.php';

/*
 * File
 */
$cache = new File([
    File::DIR => '.tmp/browscap'
]);

$bc = new Browscap();
$bc->setCache($cache);
$bc->convertFile('data/full_php_browscap.ini');

Use it

We use directly the already created cache and should have fast detection results.

use BrowscapPHP\Browscap;
use UserAgentParser\Provider;
use WurflCache\Adapter\File;

$cache = new File([
    File::DIR => '.tmp/browscap'
]);

$browscapParser = new Browscap();
$browscapParser->setCache($cache);

$provider = new Provider\BrowscapPhp($browscapParser);

$result = $provider->parse($userAgent, $headers);

DonatjUAParser

Install

composer require donatj/phpuseragentparser

Use it

use UserAgentParser\Provider;

$provider = new Provider\DonatjUAParser();

$result = $provider->parse($userAgent, $headers);

PiwikDeviceDetector

Install

composer require piwik/device-detector

Use it (without cache)

use UserAgentParser\Provider;

$provider = new Provider\PiwikDeviceDetector();

$result = $provider->parse($userAgent, $headers);

Use it (with cache)

use Doctrine\Common\Cache;
use UserAgentParser\Provider;

$piwikParser = new \DeviceDetector\DeviceDetector();
$piwikParser->setCache($new Cache\PhpFileCache('.tmp/piwik'));

$provider = new Provider\PiwikDeviceDetector($piwikParser);

$result = $provider->parse($userAgent, $headers);

SinergiBrowserDetector

Install

composer require sinergi/browser-detector

Use it

use UserAgentParser\Provider;

$provider = new Provider\SinergiBrowserDetector();

$result = $provider->parse($userAgent, $headers);

UAParser

Install

composer require ua-parser/uap-php

Use it

use UserAgentParser\Provider;

$provider = new Provider\UAParser();

$result = $provider->parse($userAgent, $headers);

WhichBrowser

Install

composer require whichbrowser/parser

Use it

use UserAgentParser\Provider;

$provider = new Provider\WhichBrowser();

$result = $provider->parse($userAgent, $headers);

Woothee

Install

composer require woothee/woothee

Use it

use UserAgentParser\Provider;

$provider = new Provider\Woothee();

$result = $provider->parse($userAgent, $headers);