README

A Laravel package to identify the visitor's browser, operating system, and device type. Results are powered by two well-tested detection libraries — no magic involved.

Fork notice: This is a maintained fork of hisorange/browser-detect by Varga Zsolt, which appears to be abandoned. Full credit to the original author for the design and initial implementation.

Changes from the original

• PHP 8.3+ and Laravel 11–13 support (dropped older versions)
• Removed ua-parser/ua-parser and mobiledetect/mobiledetect — detection is now powered by fewer, better-maintained libraries

Requirements

• PHP 8.3+
• Laravel 11, 12, or 13 (or standalone without Laravel)

Installation

composer require pataar/browser-detect

That's it — Laravel auto-discovers the service provider and facade.

Usage

Facade

use Browser;

if (Browser::isMobile()) {
    // Redirect to the mobile version of the site.
}

if (Browser::isBot()) {
    echo 'Bot detected!';
}

if (Browser::isFirefox() || Browser::isOpera()) {
    $response .= '<script src="firefox-fix.js"></script>';
}

if (Browser::isAndroid()) {
    $response .= '<a>Install our Android App!</a>';
} elseif (Browser::isMac() && Browser::isMobile()) {
    $response .= '<a>Install our iOS App!</a>';
}

Blade directives

@mobile
    <p>This is the MOBILE template!</p>
    @include('your-mobile-template')
@endmobile

@tablet
    <p>This is the TABLET template!</p>
@endtablet

@desktop
    <p>This is the DESKTOP template!</p>
@enddesktop

@browser('isBot')
    <p>Bots are identified too!</p>
@endbrowser

Standalone (without Laravel)

use hisorange\BrowserDetect\Parser as Browser;

if (Browser::isLinux()) {
    // Works without Laravel!
}

Parsing a specific user agent

$result = Browser::detect();       // Current visitor
$result = Browser::parse('Opera/9.80 (Windows NT 6.0) Presto/2.12.388 Version/12.14');

Results are cached in memory for the current request and optionally persisted via Laravel's cache (7-day TTL by default).

API Reference

Device detection

Browser detection

Operating system detection

Configuration

In Laravel, publish the config file:

php artisan vendor:publish --provider="hisorange\BrowserDetect\ServiceProvider"

In standalone mode, pass a custom config array:

use hisorange\BrowserDetect\Parser;

$browser = new Parser(null, null, [
    'cache' => [
        'interval' => 86400, // Cache TTL in seconds
    ],
]);

Available options:

Quality

This package aims for 100% test coverage and PHPStan level max with zero baseline errors.

Credits

This package was originally created by Varga Zsolt (hisorange). This fork is maintained by Pieter Willekens (pataar).

Detection is powered by:

• jaybizzle/crawler-detect — Bot and crawler detection
• matomo/device-detector — Comprehensive device, browser, and OS parsing

License

MIT