Part 1 : How to support multiple languages with laravel

Farouk BRAIK — Fri, 20 May 2022 00:32:09 +0000

Part 1 : How to support multiple languages with laravel
Part 2 : How to support multiple languages using laravel's middlewares Coming soon
Part 3 : How to support multiple languages using laravel's models Coming soon
Part 4 : How to support multiple languages using laravel's packages Coming soon

Having laravel as a backend framework has its perks, and one of them is the ability to support multiple languages (locales) through your website.

Today we are going to see how this is going to work, but first of all we are going to create a new laravel application.

By typing laravel new laravel_multi_languages we create a new applicatin:

we will then open the application with our code editor (in my case VSCode)

Important Note: I will be using laravel 9, if you have an older version it means that you should find your 'lang' folder in your 'resources' directory.

Laravel localization

Laravel's localization features provide a convenient way to retrieve strings in various languages, allowing you to easily support multiple languages within your application.

Every laravel application has a language directory somewhere, for laravel 9, a 'lang' directory should be found in the base path of the application, but for older version, it should be found inside the 'resources' directory.
laravel stores its storage in a folder structure, every folder is a locale (like 'en') and then we follow those sub folders with php files that indicates the proper translation.

/lang
    /en
        messages.php
    /es
        messages.php

all we need to use a translation is to use files with the same name for each locale and then use the same key to translate.
Let's see how to get this to work:

inside the 'lang' directory for our new project there is only 'en' locale, but that's okay, it is the default locale of a new laravel application, we will be adding another new locale for our application (Let's say French or 'fr')

the first thing we need to do is to define the supported locales of our application, this way if the user will try to switch locale, we will know if we will let them or not.

. inside our 'config' directory we open the 'app.php' file, after that, we add a new line :

// config/app.php 
...
// here we pass an array of the available locales
'locales' => ['en', 'fr'],

// this is the default locale
'locale' => 'en',
...

. right after that we create a new folder inside the 'lang' directory called 'fr' to use it for french translations, let's also create a new file called 'hello_localization.php' inside both locales' folders

/lang
    /en
        hello_localization.php
    /fr
        hello_localization.php

we want to try and say 'hello' in both french and english, we need a unique key that will refer to 'hello' in both languages, se inside each 'hello_localization.php' folder we return write like this :

// lang/en/hello_localization.php 
<?php

return [
  'hello_message' => 'Hello!'
];

And also for the other language

// lang/fr/hello_localization.php 
<?php

return [
  'hello_message' => 'Bonjour!'
];

As you can see, we gave this 'hello' a name called 'hello_message', this name indicates that the returned value should be a hello message like it says.

So right now, our application knows how to say hello in both languages which is good, but we need to test that out.

. In order to test this out we need to create a new route

// routes/web.php
...
Route::get('/say-hello', function () {
    return __('hello_localization.hello_message');
});
...

as you can see here __() is a helper function that will translate the code giving into the string, in our case we want to display the 'hello_message', but we also need to specify the file that it came from, for that we enter 'hello_localization' (without the '.php') and then writing the translation code that we want to work on.
by calling this function the application will use its own locale and tries to translate it.

the way we access and modify our application's locale is the following

// This is how we modify an application's locale
app()->setLocale($locale);

// This is how we get an application's locale 
app()->getLocale();

Let's serve our application now by using php artisan serve inside a terminal

and if we go now to 127.0.0.1:8000/say-hello, we should get a message like this:

Let's say we want to display the application's hello message in french, all we need to do is adding this line in 'web.php' file :

// routes/web.php
...
Route::get('/say-hello', function () {
    app()->setLocale('fr');
    return __('hello_localization.hello_message');
});
...

if we go again to 127.0.0.1:8000/say-hello, we should get a message like this:

Now you have a basic understanding of how localization works, in the next part, I will show you how to remember the users locale choice, and/or prevent the application from updating to a non existing locale.

Important Notice: Kindly leave me a comment or a suggesting that will help me deliver better content to you, your help is greatly appreciated.

Hello World!

Farouk BRAIK — Tue, 10 May 2022 20:49:04 +0000

“Hello World”... These are the two words that most of us developers used when we started our journey into development and programming in general.

I spent nearly 6 years of coding as a hobby, I used to learn through watching some tutorial via YouTube, reading some articles and so on, and even though I am thankful for every person that had helped me learn programming in general, I couldn’t help but noticed that after that I passed that first learning curve, there was always something missing.

That is why I decided on making some tutorials on my blog, and soon starting a YouTube video to follow after it, the purpose of this journey is to help everyone to get started on web development with a solid base and they will be capable of creating anything they want with that, but before that, I just want to point on somethings that are very important!

Computer programming in general in a vast field and it is expanding as you are reading this, but don’t worry, I don’t mean to scare or discourage you, I simply want to tell you the truth that could be either exiting for some people, or will have an opposite effect towards others. Through this journey I will be posting how to start your journey of web development from scratch and I will guide you towards a better mastery of web development by also building some web applications in the process. And so, I will encourage you to keep on reading and checking out my content as it will be updated regularly, so stay tuned!

Knowledge is power. Francis Bacon

Forem: Farouk BRAIK

Part 1 : How to support multiple languages with laravel

Laravel localization

Hello World!