Laravel Localizer
IMPORTANT: March 2022
It's horrible to see what is happening now in Ukraine, as Russian army is bombarding houses, hospitals and kindergartens.
Please check out supportukrainenow.org for the ways how you can help people there. Spread the word.
And if you are from Russia and you are against this war, please express your protest in some way. I know you can get punished for this, but you are one of the hopes of those innocent people.
Automatically detect and set an app locale that matches your visitor's preference.
- Define your supported locales and match your visitor's preference
- Uses the most common locale detectors by default
- Uses the most common locale stores by default
- Easily create and add your own detectors and stores
Requirements
- PHP >= 7.1
- Laravel >= 5.6
Install
composer require codezero/laravel-localizer
Laravel will automatically register the ServiceProvider.
Add Middleware
Add the middleware to the web
middleware group in app/Http/Kernel.php
, after StartSession
and before SubstituteBindings
:
protected $middlewareGroups = [
'web' => [
\Illuminate\Session\Middleware\StartSession::class, // <= after this
//...
\CodeZero\Localizer\Middleware\SetLocale::class,
//...
\Illuminate\Routing\Middleware\SubstituteBindings::class, // <= before this
],
];
In Laravel 6.x you also need to add the middleware to the $middlewarePriority
array in app/Http/Kernel.php
to trigger it in the correct order:
protected $middlewarePriority = [
\Illuminate\Session\Middleware\StartSession::class, // <= after this
//...
\CodeZero\Localizer\Middleware\SetLocale::class,
//...
\Illuminate\Routing\Middleware\SubstituteBindings::class, // <= before this
];
Publish Configuration File
php artisan vendor:publish --provider="CodeZero\Localizer\LocalizerServiceProvider" --tag="config"
You will now find a localizer.php
file in the config
folder.
Configure Supported Locales
Add any locales you wish to support to your published config/localizer.php
file:
'supported-locales' => ['en', 'nl', 'fr'];
Drivers
Detectors
By default the middleware will use the following detectors to check for a supported locale in:
- The URL slug
- The session
- A cookie
- The browser
- The app's default locale
If you publish the configuration file, you can choose which detectors to run and in what order.
You can also create your own detector by implementing the \CodeZero\Localizer\Detectors\Detector
interface and add a reference to it in the config file. The detectors are resolved from Laravel's IOC container, so you can add any dependencies to your constructor.
Stores
The first supported locale that is returned by a detector will then be stored in:
- The session
- A cookie
- The app locale
If you publish the configuration file, you can choose which stores to use.
You can also create your own store by implementing the \CodeZero\Localizer\Stores\Store
interface and add a reference to it in the config file. The stores are resolved from Laravel's IOC container, so you can add any dependencies to your constructor.
Testing
composer test
Security
If you discover any security related issues, please e-mail me instead of using the issue tracker.
Changelog
A complete list of all notable changes to this package can be found on the releases page.
License
The MIT License (MIT). Please see License File for more information.