hisorange/browser-detect

In a Laravel environment, you can use the Browser facade to identify device types, operating systems, and browser vendors. This works in both controllers and Blade templates.

In PHP code

Use the Browser facade to perform checks:

use Browser;

// Device type checks
$isMobile = Browser::isMobile();
Browser::isTablet();
Browser::isDesktop();

// Bot detection
if (Browser::isBot()) {
    // Logic for bots
}

// Browser vendor checks
if (Browser::isFirefox() || Browser::isOpera()) {
    // Logic for specific browsers
}

// OS checks
if (Browser::isAndroid()) {
    // Logic for Android
} elseif (Browser::isMac() && Browser::isMobile()) {
    // Logic for iOS
}

In Blade templates

The package provides custom Blade directives for easy conditional rendering:

@mobile
    <p>This is the MOBILE template!</p>
@endmobile

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

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

{{-- You can also use any result key via the @browser directive --}}
@browser('isBot')
    <p>Bots are identified too :)</p>
@endbrowser

use Browser;

// Determine the user's device type is simple as this:
$isMobile = Browser::isMobile();
Browser::isTablet();
Browser::isDesktop();

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

// Every wondered if it is a bot who loading Your page?
if (Browser::isBot()) {
    echo 'No need to wonder anymore!';
}

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

// Sometimes You may want to serve different content based on the OS.
if (Browser::isAndroid()) {
    $response .= '<a>Install our Android App!</a>';
} elseif (Browser::isMac() && Browser::isMobile()) {
    $response .= '<a>Install our iOS App!</a>';
}

Every call on the Browser facade is proxied to a result object. The following methods are available:

The hisorange\BrowserDetect\Result class is the object returned after a detection process. It provides a safe, structured way to access parsed information about the user agent, including browser type, device category, platform, and versioning.

Key capabilities include:

• Device Detection: Check if the user is on isMobile(), isTablet(), isDesktop(), or isBot().
• Browser Detection: Check for specific browsers like isChrome(), isFirefox(), isOpera(), isSafari(), isEdge(), or isIE().
• Platform Detection: Check for operating systems like isWindows(), isLinux(), isMac(), or isAndroid().
• Version Comparison: Use isIEVersion(int $version, string $operator) to check Internet Explorer versions using standard comparison operators (e.g., '=', '>', '<').
• Data Export: Convert the result to an array via toArray() or serialize it to JSON via jsonSerialize().

// Assuming $result is an instance of hisorange\BrowserDetect\Result

if ($result->isMobile()) {
    echo "User is on a mobile device";
}

if ($result->isChrome()) {
    echo "Browser: " . $result->browserName();
}

if ($result->isIEVersion(11, '>=')) {
    echo "User is using IE 11 or newer";
}

echo "Device Type: " . $result->deviceType(); // Returns 'Mobile', 'Tablet', 'Bot', 'Desktop', or 'Unknown'

The BrowserDetect stage is responsible for refining the detection payload by resolving device types, identifying browser vendors, formatting human-readable names, and detecting in-app environments.

When this stage processes a PayloadInterface, it sets or updates the following keys in the payload:

Device Type Resolution

• isMobile: true if the device is mobile.
• isTablet: true if the device is a tablet.
• isDesktop: true if the device is a desktop.
• isBot: true if the User Agent contains 'Prerender'.

Browser Identification

• isChrome, isFirefox, isOpera, isSafari, isIE, isEdge: Boolean flags based on the browserFamily.
• browserVersion: A human-readable string (e.g., 12.1) constructed from major, minor, and patch versions.
• browserName: A combined string of browserFamily and browserVersion.

Platform Identification

• isWindows, isAndroid, isMac, isLinux: Boolean flags based on the platformFamily.
• platformVersion: A human-readable string constructed from major, minor, and patch versions.
• platformName: A combined string of platformFamily and platformVersion.

Special Detection

• isInApp: true if the User Agent matches known in-app patterns (e.g., WebView, Twitter, MicroMessenger, or specific iOS/Android in-app patterns).

The DeviceDetector stage is used to identify the device type, brand, model, operating system (platform), and browser details from a User Agent string. It is designed to skip bot detection to focus on actual user devices.

When this stage processes a payload, it populates the following keys in the payload:

Platform Information

• platformFamily: The name of the operating system.
• platformVersion: The full version string.
• platformVersionMajor: The major version number.
• platformVersionMinor: The minor version number.
• platformVersionPatch: The patch version number.

Browser Information

• browserFamily: The name of the browser.
• browserEngine: The browser engine used.
• browserVersion: The full version string.
• browserVersionMajor: The major version number.
• browserVersionMinor: The minor version number.
• browserVersionPatch: The patch version number.

Device Information

• isDesktop: true if the device type is desktop.
• isTablet: true if the device type is tablet.
• isMobile: true if the device type is smartphone, feature phone, or phablet.
• deviceFamily: The full name of the device brand.
• deviceModel: The specific model of the device.