flamix/laravel-lang

Laravel Language Detection.

dev-main 2026-04-12 15:08 UTC

Requires

• laravel-lang/common: ^6.0
• laravel/framework: >=10.0

MIT

• Roman Shkabko

README

Language detection and switching for Laravel. Uses a driver-based approach: cookies, authenticated user, browser headers, URL prefix.

Install

composer require flamix/laravel-lang

Publish config:

php artisan vendor:publish --provider="Flamix\Lang\ServiceProvider" --tag=config

Configuration

// config/lang.php
return [
    // Auto-register SetLang middleware in "web" group
    'autoload' => env('LANG_AUTOLOAD', true),

    // Available languages
    'available' => [
        'en' => 'English',
        'ru' => 'Русский',
        'ua' => 'Українська',
    ],

    // Detection drivers (checked top to bottom, first match wins)
    'drivers' => [
        'get' => [
            \Flamix\Lang\Drivers\Cookies::class,
            \Flamix\Lang\Drivers\AuthUser::class,  // requires `lang` column on users table
            \Flamix\Lang\Drivers\Browser::class,    // reads Accept-Language header
        ],
        // Where to persist when user switches language
        'set' => [
            \Flamix\Lang\Drivers\Cookies::class,
            \Flamix\Lang\Drivers\AuthUser::class,
        ],
    ],
];

Usage

Helpers

// Get current language (runs through detection drivers)
lang()->get(); // "en"

// Set language (persists to all "set" drivers)
lang()->set('ru');

// Generate named route with locale prefix
lang_route('dashboard'); // route("en.dashboard")

Language switcher

Built-in route to change language via GET request:

GET /lang/change/{lang}

<a href="{{ route('lang.change', 'en') }}">English</a>
<a href="{{ route('lang.change', 'ru') }}">Русский</a>

Sets the language in all configured set drivers and redirects back.

Middleware

Two middlewares are registered automatically:

lang-set — detects and applies locale. Auto-added to web group when autoload is true.

// Manual registration if autoload is disabled
Route::middleware('lang-set')->group(function () {
    // ...
});

lang-prefix — for URL-prefix-based localization (/en/about, /ru/about). Redirects to prefixed URL if prefix is missing.

// routes/web.php
Route::prefix('{lang}')->middleware('lang-prefix')->group(function () {
    Route::get('/about', [AboutController::class, 'index'])->name('about');
});

Requires Prefix driver in your config:

'get' => [
    \Flamix\Lang\Drivers\Prefix::class,
    \Flamix\Lang\Drivers\Cookies::class,
    // ...
],

Drivers

Driver	Detects	Persists	Notes
Cookies	lang cookie	Forever cookie	Default, works for guests
AuthUser	auth()->user()->lang	Updates user model	Requires lang column
Browser	Accept-Language header	--	Read-only, fallback
Prefix	URL first segment (/en/...)	--	Read-only, use with lang-prefix middleware

Custom driver

use Flamix\Lang\Drivers\AbstractDriver;
use Flamix\Lang\Drivers\Contracts\DetectInterface;
use Flamix\Lang\Drivers\Contracts\SetInterface;

class SessionDriver extends AbstractDriver implements DetectInterface, SetInterface
{
    public function detect(): ?string
    {
        $lang = session('lang');
        return $this->isAvailable($lang) ? $lang : null;
    }

    public function set(string $lang): mixed
    {
        session(['lang' => $lang]);
        return $lang;
    }
}

Add to config:

'drivers' => [
    'get' => [SessionDriver::class, ...],
    'set' => [SessionDriver::class, ...],
],

DetectInterface — for detection only (like Browser). Add SetInterface if the driver can persist.