Laravel 5.3 add multi-language functionality

During a recent project, we faced the issue of adding a multi-language functionality to our application.

We store our Laravel applications on DigitalOcean, but this tutorial will work basically on any other hosting company.

Using Laravel middlewares we found a quite easy and straight forward solution.

In this tutorial we will show you how to easily create your own.

Add available locales in the configurations

In order to allow only certain locales to work , simple add right below the locale key  in config/app.php the following array:

'locales' => [
    'en' => 'English',
    'it' => 'Italiano'],

Create a custom middleware

First let’s create a custom middleware running the following command.

php artisan make:middleware Language

This will create Language.php in App\Http\Middleware. Modify the handle method adding your own logic, in our example we will use a query parameter _locale to modify the application locale and set a _locale session variable to store this choice and maintain the locale across various pages.

public function handle($request, Closure $next)
    $locales = config('app.locales');
    $locale = $request->get('_locale');
    if(!is_null($locale) && is_array($locales) && array_key_exists($locale, $locales)){
    return $next($request);

Modify the middleware web group

Now we just need to tell Laravel how to use the our class. We found that adding this middleware to the “web” middleware group was pretty comfortable so , open the App\Http\Kernel and insert your Language class declaration in the web array like the code below:

 * The application's route middleware groups.
 * @var array
protected $middlewareGroups = [
    'web' => [

    'api' => [

That’s it, now you can change your app locale simply using ?_locale=it in the url.