README

Code Status

Requirements

This library requires PHP 7.1+. Also a PSR-3 compatible logger and a PSR-16 compatible cache are required.

Installation

Run the command below to install via Composer

composer require mimmi20/browser-detector

Preparation

Before you can use this library, you have to warmup the cache. This should be done not in the same process like the detection.

$detector = new \BrowserDetector\Detector($cache, $logger);

$detector->warmupCache();

Usage

$detector = new \BrowserDetector\Detector($cache, $logger);

// generic call (deprecated)
$result = $detector->getBrowser($request);

// call depending on the data
$result = $detector->parseString($request);
$result = $detector->parseArray($request);
$result = $detector->parseMessage($request); // for a PSR7 MessageInterface

The request parameter may be a string, an array or a PSR-7 compatible message.

Usage Examples

Taking the user agent from the global $_SERVER variable

$detector = new \BrowserDetector\Detector($cache, $logger);

// generic call (deprecated)
$result = $detector->getBrowser($_SERVER);

// call depending on the data
$result = $detector->parseArray($_SERVER);

Using a sample useragent

$detector = new \BrowserDetector\Detector($cache, $logger);

// generic call (deprecated)
$result = $detector->getBrowser($the_user_agent);

// call depending on the data
$result = $detector->parseString($the_user_agent);

The result

The getBrowser function and the parse* functions return a ua-result object.

Issues and feature requests

Please report your issues and ask for new features on the GitHub Issue Tracker at https://github.com/mimmi20/BrowserDetector/issues