README

A comprehensive Laravel package for detecting browsers, devices, robots, platforms, and Tor connections with advanced user agent parsing.

Features

🌐 Browser Detection: Chrome, Firefox, Safari, Edge, Opera, Brave, Tor, and more
📱 Mobile Device Detection: Detect mobile brands and models (Samsung, iPhone, Xiaomi, etc.)
💻 Desktop Detection: Identify desktop browsers and operating systems
🤖 Robot/Bot Detection: Identify search engine crawlers and bots
🔒 Tor Detection: Real-time Tor exit node detection with caching
🖥️ Platform Detection: Windows, macOS, Linux, Android, iOS, etc.
📊 Tablet Detection: Identify tablets and their models
⚡ Performance: Cached Tor nodes, optimized regex patterns
🎯 Client Hints Support: Uses modern Sec-CH-UA headers

Installation

Install via Composer:

composer require sajidwarner/laravel-device-detector

Laravel Auto-Discovery

The package will automatically register the service provider and facade.

Manual Registration (Optional)

If auto-discovery is disabled, add to config/app.php:

'providers' => [
    SajidWarner\DeviceDetector\DeviceDetectorServiceProvider::class,
],

'aliases' => [
    'DeviceDetector' => SajidWarner\DeviceDetector\Facades\DeviceDetector::class,
],

Publish Configuration

php artisan vendor:publish --provider="SajidWarner\DeviceDetector\DeviceDetectorServiceProvider"

Usage

Basic Usage

use SajidWarner\DeviceDetector\Facades\DeviceDetector;

// Detect current request
$device = DeviceDetector::detect();

// Get specific information
$browser = DeviceDetector::getBrowser();
$platform = DeviceDetector::getPlatform();
$deviceType = DeviceDetector::getDeviceType();
$isMobile = DeviceDetector::isMobile();
$isTablet = DeviceDetector::isTablet();
$isDesktop = DeviceDetector::isDesktop();
$isRobot = DeviceDetector::isRobot();
$isTor = DeviceDetector::isTor();

Full Detection Array

$data = DeviceDetector::detect();

/*
Returns:
[
    'browser' => 'Google Chrome',
    'browser_version' => '120.0',
    'platform' => 'Windows 10',
    'device_type' => 'desktop',
    'device_brand' => null,
    'device_model' => null,
    'is_mobile' => false,
    'is_tablet' => false,
    'is_desktop' => true,
    'is_robot' => false,
    'is_tor' => false,
    'robot_name' => null,
    'ip' => '192.168.1.1'
]
*/

In Controllers

use Illuminate\Http\Request;
use SajidWarner\DeviceDetector\Facades\DeviceDetector;

class HomeController extends Controller
{
    public function index(Request $request)
    {
        $device = DeviceDetector::detect($request);
        
        if ($device['is_mobile']) {
            return view('mobile.home', compact('device'));
        }
        
        if ($device['is_robot']) {
            return response('Bot detected: ' . $device['robot_name']);
        }
        
        return view('home', compact('device'));
    }
}

Middleware Usage

Create a middleware to block Tor or bots:

php artisan make:middleware BlockTor

use SajidWarner\DeviceDetector\Facades\DeviceDetector;

public function handle($request, Closure $next)
{
    if (DeviceDetector::isTor($request)) {
        return response('Tor connections not allowed', 403);
    }
    
    return $next($request);
}

Blade Directives

@mobile
    <p>Mobile view content</p>
@endmobile

@desktop
    <p>Desktop view content</p>
@enddesktop

@tablet
    <p>Tablet view content</p>
@endtablet

@robot
    <p>Bot detected</p>
@endrobot

@tor
    <p>Tor browser detected</p>
@endtor

Detected Browsers

Google Chrome
Mozilla Firefox
Safari
Microsoft Edge
Opera / Opera GX
Brave
Vivaldi
Tor Browser
Kahf Browser
Samsung Internet
UC Browser
Internet Explorer
And many more...

Detected Mobile Brands

Apple (iPhone, iPad)
Samsung
Xiaomi
Huawei
OnePlus
Oppo
Vivo
Google (Pixel)
Motorola
Nokia
LG
Sony
And more...

Detected Robots/Bots

Googlebot
Bingbot
Yahoo Slurp
DuckDuckBot
Baiduspider
YandexBot
Facebook Bot
Twitter Bot
LinkedIn Bot
And many more...

Configuration

Edit config/device-detector.php:

return [
    // Cache duration for Tor exit nodes (in seconds)
    'tor_cache_duration' => 3600,
    
    // Tor exit nodes URL
    'tor_exit_node_url' => 'https://check.torproject.org/exit-addresses',
    
    // Enable/disable Tor detection
    'enable_tor_detection' => true,
    
    // Enable/disable robot detection
    'enable_robot_detection' => true,
];

API Routes

The package provides test routes (disabled in production):

GET /device-detector/test

Returns JSON with detected device information.

Requirements

PHP >= 8.1
Laravel >= 10.0

Testing

composer test

Security

If you discover any security issues, please email bestcyberking@gmail.com instead of using the issue tracker.

Credits

Syed Sajid Akram - Package Author & Maintainer
Claude.ai - AI Assistant by Anthropic (Package Development & Architecture)
ChatGPT - AI Assistant by OpenAI (Code Assistance & Suggestions)
Google Gemini - AI Assistant by Google (Code Assistance & Suggestions)

License

The MIT License (MIT). Please see License File for more information.

Support

For support, please open an issue on GitHub.

sajidwarner / laravel-device-detector

Maintainers

Details