https://github.com/mimmi20/browser-detector

Library for PHP 8.1+ to detect Browsers and Devices
https://github.com/mimmi20/browser-detector

detect php php83 ua-parser user-agent user-agent-parser

Last synced: about 2 months ago
JSON representation

Library for PHP 8.1+ to detect Browsers and Devices

• Host: GitHub
• URL: https://github.com/mimmi20/browser-detector
• Owner: mimmi20
• License: mit
• Created: 2013-09-09T20:06:56.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2025-04-02T07:11:47.000Z (about 2 months ago)
• Last Synced: 2025-04-02T07:22:19.231Z (about 2 months ago)
• Topics: detect, php, php83, ua-parser, user-agent, user-agent-parser
• Language: PHP
• Homepage: https://github.com/mimmi20/BrowserDetector
• Size: 749 MB
• Stars: 44
• Watchers: 6
• Forks: 11
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# BrowserDetector

[![Latest Stable Version](https://poser.pugx.org/mimmi20/browser-detector/v/stable?format=flat-square)](https://packagist.org/packages/mimmi20/browser-detector)

[![Latest Unstable Version](https://poser.pugx.org/mimmi20/browser-detector/v/unstable?format=flat-square)](https://packagist.org/packages/mimmi20/browser-detector)

[![License](https://poser.pugx.org/mimmi20/browser-detector/license?format=flat-square)](https://packagist.org/packages/mimmi20/browser-detector)

## Code Status

[![codecov](https://codecov.io/gh/mimmi20/BrowserDetector/branch/master/graph/badge.svg)](https://codecov.io/gh/mimmi20/BrowserDetector)

[![Test Coverage](https://api.codeclimate.com/v1/badges/e310a7977d6a375c9dd7/test_coverage)](https://codeclimate.com/github/mimmi20/browser-detector/test_coverage)

[![Average time to resolve an issue](https://isitmaintained.com/badge/resolution/mimmi20/BrowserDetector.svg)](https://isitmaintained.com/project/mimmi20/BrowserDetector "Average time to resolve an issue")

[![Percentage of issues still open](https://isitmaintained.com/badge/open/mimmi20/BrowserDetector.svg)](https://isitmaintained.com/project/mimmi20/BrowserDetector "Percentage of issues still open")

[![Mutation testing badge](https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2Fmimmi20%2Fbrowser-detector%2Fmaster)](https://dashboard.stryker-mutator.io/reports/github.com/mimmi20/browser-detector/master)

[![Maintainability](https://api.codeclimate.com/v1/badges/e310a7977d6a375c9dd7/maintainability)](https://codeclimate.com/github/mimmi20/browser-detector/maintainability)

## Requirements

This library requires PHP 8.3+.

Also a PSR-3 compatible logger and a PSR-16 compatible cache are required.

## Installation

Run the command below to install via Composer

```shell

composer require mimmi20/browser-detector

```

## Usage

```php

$detectorFactory = new \BrowserDetector\DetectorFactory($cache, $logger);

$detector        = $detectorFactory();

// get the result

$result = $detector->getBrowser($request);

```

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

```php

$detectorFactory = new \BrowserDetector\DetectorFactory($cache, $logger);

$detector        = $detectorFactory();

$result = $detector->getBrowser($_SERVER);

```

### Using a sample useragent

```php

$detectorFactory = new \BrowserDetector\DetectorFactory($cache, $logger);

$detector        = $detectorFactory();

$result = $detector->getBrowser($the_user_agent);

```

## The result

The `getBrowser` function returns an array with this structure

```php

[

    'headers' => [],

    'device' => [

        'architecture' => null,

        'deviceName' => null,

        'marketingName' => null,

        'manufacturer' => 'unknown',

        'brand' => 'unknown',

        'dualOrientation' => null,

        'simCount' => null,

        'display' => [

            'width' => null,

            'height' => null,

            'touch' => null,

            'size' => null,

        ],

        'type' => 'unknown',

        'ismobile' => null,

        'istv' => null,

        'bits' => null,

    ],

    'os' => [

        'name' => null,

        'marketingName' => null,

        'version' => null,

        'manufacturer' => 'unknown',

    ],

    'client' => [

        'name' => null,

        'modus' => null,

        'version' => null,

        'manufacturer' => 'unknown',

        'type' => 'unknown',

        'isbot' => null,

    ],

    'engine' => [

        'name' => null,

        'version' => null,

        'manufacturer' => 'unknown',

    ],

]

```

## Issues and feature requests

Please report your issues and ask for new features on the GitHub Issue Tracker

at