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

Method	Returns	Description
`Browser::isMobile()`	`bool`	Is this a mobile device?
`Browser::isTablet()`	`bool`	Is this a tablet device?
`Browser::isDesktop()`	`bool`	Is this a desktop computer?
`Browser::isBot()`	`bool`	Is this a crawler / bot?
`Browser::deviceType()`	`string`	One of: `Mobile`, `Tablet`, `Desktop`, `Bot`
`Browser::deviceFamily()`	`string`	Device vendor (Samsung, Apple, Huawei, ...)
`Browser::deviceModel()`	`string`	Device model (iPad, iPhone, Nexus, ...)

Browser detection

Method	Returns	Description
`Browser::browserName()`	`string`	Human-friendly name (e.g. `Firefox 3.6`)
`Browser::browserFamily()`	`string`	Vendor (Chrome, Firefox, Opera, ...)
`Browser::browserVersion()`	`string`	Version string with trailing `.0` trimmed
`Browser::browserVersionMajor()`	`int`	Semantic major version
`Browser::browserVersionMinor()`	`int`	Semantic minor version
`Browser::browserVersionPatch()`	`int`	Semantic patch version
`Browser::browserEngine()`	`string`	Rendering engine (Blink, WebKit, Gecko, ...)
`Browser::isChrome()`	`bool`	Chrome or Chromium?
`Browser::isFirefox()`	`bool`	Firefox?
`Browser::isOpera()`	`bool`	Opera?
`Browser::isSafari()`	`bool`	Safari?
`Browser::isEdge()`	`bool`	Microsoft Edge?
`Browser::isIE()`	`bool`	Internet Explorer (or Trident)?
`Browser::isIEVersion(int, op)`	`bool`	Compare against a specific IE version
`Browser::isInApp()`	`bool`	In-app browser (WebView, Twitter, WeChat)?

Operating system detection

Method	Returns	Description
`Browser::platformName()`	`string`	Human-friendly name (e.g. `Windows 10`)
`Browser::platformFamily()`	`string`	Vendor (Linux, Windows, Mac, ...)
`Browser::platformVersion()`	`string`	Version string with trailing `.0` trimmed
`Browser::platformVersionMajor()`	`int`	Semantic major version
`Browser::platformVersionMinor()`	`int`	Semantic minor version
`Browser::platformVersionPatch()`	`int`	Semantic patch version
`Browser::isWindows()`	`bool`	Windows?
`Browser::isLinux()`	`bool`	Linux?
`Browser::isMac()`	`bool`	macOS or iOS?
`Browser::isAndroid()`	`bool`	Android?

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:

Key	Default	Description
`cache.interval`	`10080`	Cache TTL in seconds
`cache.prefix`	`bd4_`	Cache key prefix
`security.max-header-length`	`2048`	Max user agent length (DoS protection)

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

pataar / browser-detect

Maintainers

Package info

Statistics

Security