PHPackages                             acsiomatic/device-detector-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. acsiomatic/device-detector-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

acsiomatic/device-detector-bundle
=================================

Symfony Bundle for https://github.com/matomo-org/device-detector

0.6.0(1y ago)12183.6k↓32.2%1[2 issues](https://github.com/acsiomatic/device-detector-bundle/issues)MITPHPPHP ^8.1CI passing

Since Nov 29Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/acsiomatic/device-detector-bundle)[ Packagist](https://packagist.org/packages/acsiomatic/device-detector-bundle)[ RSS](/packages/acsiomatic-device-detector-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (10)Versions (7)Used By (0)

AcsiomaticDeviceDetectorBundle
==============================

[](#acsiomaticdevicedetectorbundle)

The `AcsiomaticDeviceDetectorBundle` provides integration of the [DeviceDetector](https://github.com/matomo-org/device-detector) library into the [Symfony](https://symfony.com/) framework.

> [DeviceDetector](https://github.com/matomo-org/device-detector) is a Universal Device Detection library that parses User Agents and Browser Client Hints to detect devices (desktop, tablet, mobile, tv, cars, console, etc.), clients (browsers, feed readers, media players, PIMs, ...), operating systems, brands and models.
>
> From

This bundle provides the [`DeviceDetector` class](https://github.com/matomo-org/device-detector/blob/master/DeviceDetector.php) as [service](https://symfony.com/doc/current/service_container.html#fetching-and-using-services), and [Twig global variable](https://symfony.com/doc/current/templates.html#global-variables).

- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
    - [Usage in controllers](#usage-in-controllers)
    - [Usage in Twig](#usage-in-twig)
    - [Usage in route condition](#usage-in-route-condition)
    - [Parsing custom request](#parsing-custom-request)
- [Release Policy](#release-policy)
    - [Dependencies Compatibility Policy](#dependencies-compatibility-policy)

Installation
------------

[](#installation)

You can install the bundle using [Composer](https://getcomposer.org/):

```
composer require acsiomatic/device-detector-bundle
```

Configuration
-------------

[](#configuration)

You can configure the bundle using the `acsiomatic_device_detector` configuration section:

```
# config/packages/acsiomatic_device_detector.yaml

acsiomatic_device_detector:

    # If true, DeviceDetector will trigger parser() when necessary
    auto_parse: true

    # Version truncation behavior, it may assume: major, minor, patch, build, or none
    # By default minor versions will be returned (e.g. X.Y)
    version_truncation: 'minor'

    cache:

        # If null, it will disable caching
        pool: 'cache.app'

    bot:

        # If true getBot() will only return true if a bot was detected (speeds up detection a bit)
        discard_information: false

        # If true, bot detection will completely be skipped (bots will be detected as regular devices then)
        skip_detection: false

    twig:

        # If null, it will not assign Twig variable
        variable_name: 'device'

    routing:

        # If null, it will not tag DeviceDetector as routing condition service
        condition_service_alias: 'device'
```

Usage
-----

[](#usage)

### Usage in controllers

[](#usage-in-controllers)

You can inject `DeviceDetector` as a service. This bundle sets up an instance of this class according to the configurations under the `acsiomatic_device_detector` section in order to provide information about the main request.

```
use DeviceDetector\DeviceDetector;
use Symfony\Component\HttpFoundation\Response;

class MyController
{
    public function index(DeviceDetector $device): Response
    {
        if ($device->isSmartphone()) {
            // ...
        }
    }
}
```

Note

You need to call `$device->parse()` before asking for device's information if `auto_parse` configuration is false.

### Usage in Twig

[](#usage-in-twig)

The `DeviceDetector` service is assigned to the Twig templates as `device` variable.

```
{% if device.isSmartphone %}
    {# ... #}
{% endif %}
```

### Usage in route condition

[](#usage-in-route-condition)

The `DeviceDetector` is tagged as routing condition service.

```
use Symfony\Component\HttpFoundation\Response;

class MyController
{
    #[Route('/page', condition: "service('device').isSmartphone()")]
    public function index(): Response
    {
        // this endpoint is available only for smartphone devices
    }
}
```

### Parsing custom request

[](#parsing-custom-request)

You might want to parse other request than the current one. This bundle provides a service that implements [DeviceDetectorFactoryInterface](src%2FContracts%2FDeviceDetectorFactoryInterface.php). This service provides methods that create fresh `DeviceDetector` instances according to the configurations under the `acsiomatic_device_detector` section, but it doesn't attach them to any request.

Custom parsers
--------------

[](#custom-parsers)

You can inject custom parsers into `DeviceDetector` by providing them as services.

If [autoconfigure](https://symfony.com/doc/current/service_container.html#the-autoconfigure-option) is enabled, the bundle injects custom parsers. Otherwise, you need to add the corresponding tag to each custom parsers:

- `acsiomatic.device_detector.bot_parser`
- `acsiomatic.device_detector.client_parser`
- `acsiomatic.device_detector.device_parser`

Release Policy
--------------

[](#release-policy)

There is a **single** maintained branch per time. This branch targets a minor version.

A maintained version reaches its end-of-life when a new minor version is released.

### Dependencies Compatibility Policy

[](#dependencies-compatibility-policy)

This library is compatible with maintained versions of [PHP](https://www.php.net/supported-versions.php), [Device Detector](https://github.com/matomo-org/device-detector/branches), and [Symfony](https://symfony.com/releases#sf-versions).

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance61

Regular maintenance activity

Popularity41

Moderate usage in the ecosystem

Community12

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~283 days

Recently: every ~327 days

Total

6

Last Release

579d ago

PHP version history (4 changes)0.1.0PHP >=7.0

0.3.0PHP ^7.0 || ^8.0

0.4.0PHP ^7.2 || ^8.0

0.6.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/4e1aa2e77d3574f9aa318fde02fe0f6113404f44c244529caceed0e1dadf4b66?d=identicon)[renanbr](/maintainers/renanbr)

![](https://www.gravatar.com/avatar/93bd8aad6041bd2caf4b082421ce40fe4b8f69902240ebe09f75cb23120ab924?d=identicon)[Rene Lima](/maintainers/Rene%20Lima)

---

Top Contributors

[![renedelima](https://avatars.githubusercontent.com/u/18712090?v=4)](https://github.com/renedelima "renedelima (16 commits)")[![pierrelemee](https://avatars.githubusercontent.com/u/7372352?v=4)](https://github.com/pierrelemee "pierrelemee (2 commits)")

---

Tags

bot-detectiondetection-librarydevice-detectormobile-detectionphpsymfonysymfony-bundleuser-agentuser agentSymfony Bundledevice detectordetection-librarybot-detectionmobile-detection

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/acsiomatic-device-detector-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/acsiomatic-device-detector-bundle/health.svg)](https://phpackages.com/packages/acsiomatic-device-detector-bundle)
```

###  Alternatives

[hisorange/browser-detect

Browser & Mobile detection package for Laravel.

1.1k10.1M50](/packages/hisorange-browser-detect)[thadafinser/user-agent-parser

UserAgent parsing done right http://useragent.mkf.solutions/

249316.9k2](/packages/thadafinser-user-agent-parser)[jbtronics/settings-bundle

A symfony bundle to easily create typesafe, user-configurable settings for symfony applications

9546.7k2](/packages/jbtronics-settings-bundle)[pixelopen/cloudflare-turnstile-bundle

A simple package to help integrate Cloudflare Turnstile on Symfony.

31205.8k3](/packages/pixelopen-cloudflare-turnstile-bundle)[fkr/simplepie-bundle

Integrates SimplePie into Symfony

11137.5k](/packages/fkr-simplepie-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)