laravel-mobile-detect maintained by marcover9000
Laravel Mobile Detect
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:clearfor 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:clearto 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