README

A package that enables you to use device detection right in your Blade templates. (Utilises the well-known, constantly updated PHP mobile detection library.)

Maintained fork for Laravel 12 by Marc (marcover9000). Original package by Barnabas Kecskes (riverskies), MIT licensed.

When would you use this package?

Responsive CSS may help to make content in the browser look nice on different devices but it won't help you serve responsive content from your backend (at least not the easy way). This can have a really bad knock-on effect on the user experience (have you ever waited for a large image to load while having a bad connection on your mobile?). This package will make it a breeze to serve device-specific content right from your back-end.

How does this package work?

The package implements various Blade directives that you can use to serve different content from your Blade template for different device types.

Installation

Install the package through Composer:

composer require marcover9000/laravel-mobile-detect

On Laravel 12 the service provider and the optional MobileDetect facade are auto-discovered — no manual registration needed.

NOTE You might have to run php artisan view:clear for the Blade directives to take effect.

Usage

Use the new Blade directives in your template files:

@desktop
    <img src="/path/to/high-definition/image"/>
@elsedesktop
    <img src="/path/to/handheld-optimised/image"/>
@enddesktop

NOTE You might have to run php artisan view:clear to have the new Blade directives take effect!

Available directives

@desktop, @elsedesktop, @enddesktop - for destkop devices

@handheld, @elsehandheld, @endhandheld - for non-desktop (mobile and tablet) devices

@tablet, @elsetablet, @endtablet - for tablet devices

@nottablet, @elsenottablet, @endnottablet - for non-tablet (desktop or mobile) devices

@mobile, @elsemobile, @endmobile - for mobile devices

@notmobile, @elsenotmobile, @endnotmobile - for non-mobile (desktop or tablet) devices

@ios, @elseios, @endios - for iOS platforms

@android, @elseandroid, @endandroid - for Android platforms

@device('Rule'), @elsedevice, @enddevice - for any mobiledetect rule (e.g. @device('iPhone'), @device('AndroidOS'), @device('Chrome'))

@bot, @elsebot, @endbot - for crawlers/bots

@notbot, @elsenotbot, @endnotbot - for non-bots

@deviceclass - echoes mobile, tablet or desktop (e.g. <body class="@deviceclass">)

The usage of @else... directives are optional.

Outside Blade

In controllers or middleware, use the facade (auto-discovered, no manual setup on Laravel 12) or the device_type() helper:

use Riverskies\Laravel\MobileDetect\Facades\MobileDetect;

if (MobileDetect::isMobile()) { /* ... */ }
MobileDetect::is('iOS');

device_type(); // 'mobile' | 'tablet' | 'desktop'

In a queued job or CLI context there is no request, so set the User-Agent explicitly (every directive, device_type() and @deviceclass then honour it):

MobileDetect::useAgent($userAgentCapturedFromTheRequest);

Testing

In your application's tests you can fake the detected device without mocking anything:

use Riverskies\Laravel\MobileDetect\Facades\MobileDetect;

MobileDetect::fake('mobile');   // also: 'tablet', 'desktop', 'bot'
MobileDetect::fake('iPhone');   // any mobiledetect rule, drives @device('iPhone')

The fake is scoped to the test (a fresh app per test); the presets mobile/tablet/desktop/bot drive the device-type and bot directives, a rule name drives @device('Rule').

Development

This package ships a Docker dev environment (PHP 8.3 + Composer):

docker compose build
docker compose run --rm dev composer install
docker compose run --rm dev vendor/bin/phpunit

marcover9000 / laravel-mobile-detect

Maintainers

Package info

Statistics

Security