reefki/laravel-device-detector

Laravel wrapper for Matomo's Universal Device Detection library.

v1.0.2 2025-03-02 02:50 UTC

Requires

• laravel/framework: ^9.0|^10.0|^11.0|^12.0
• matomo/device-detector: ^6.0

Requires (Dev)

• laravel/pint: ^1.13
• orchestra/testbench: ^7.0|^8.0
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^10.0

MIT

• Rifki Aria Gumelar

README

The Laravel wrapper for Matomo Universal Device Detection library seamlessly integrates device detection capabilities into Laravel applications.

Installation

This package can be installed through Composer.

composer require reefki/laravel-device-detector

Optionally, you can publish the config file of this package with this command:

php artisan vendor:publish --provider="Reefki\DeviceDetector\DeviceDetectorServiceProvider" --tag="config"

Usage

Detect device from a user agent string:

use Reefki\DeviceDetector\Device;

$device = Device::detect($request->userAgent());

Detect device from a user agent string and optional hints:

use Reefki\DeviceDetector\Device;

$device = Device::detect($request->userAgent(), $request->server());

Detect device from a request instance:

use Reefki\DeviceDetector\Device;

$device = Device::detectRequest($request);

Detect device directly from a request instance:

$device = $request->device();

All of the above methods wil return a DeviceDetector\DeviceDetector instance which you can use to get the information about the device:

if ($device->isBot()) {
    $botInfo = $device->getBot();
} else {
    $clientInfo = $device->getClient();
    $osInfo = $device->getOs();
    $device = $device->getDeviceName();
    $brand = $device->getBrandName();
    $model = $device->getModel();
}

Read the Matomo's Universal Device Detection library readme for more information on how to use the returned instance.

Testing

Run the tests with:

vendor/bin/phpunit

Credits

• Matomo Universal Device Detection
• All Contributors

License

The MIT License (MIT). Please see License File for more information.