{"id":507,"date":"2025-08-30T19:16:12","date_gmt":"2025-08-30T19:16:12","guid":{"rendered":"https:\/\/1v0.net\/blog\/?p=507"},"modified":"2025-08-30T19:16:14","modified_gmt":"2025-08-30T19:16:14","slug":"how-to-build-multi-language-i18n-support-in-laravel","status":"publish","type":"post","link":"https:\/\/1v0.net\/blog\/how-to-build-multi-language-i18n-support-in-laravel\/","title":{"rendered":"How to Build Multi-Language (i18n) Support in Laravel"},"content":{"rendered":"\n

How to Build Multi-Language (i18n) Support in Laravel 12<\/strong><\/h2>\n\n\n\n

Modern applications often need to serve users in multiple languages. Laravel 12 makes it easy to implement multi-language (i18n) support<\/strong> with built-in localization features. In this article, you\u2019ll configure locales, create translation files, switch languages from controllers and middleware, and add a simple language switcher UI for your Blade views.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Configure Locales in Laravel<\/strong><\/h2>\n\n\n\n

Set the default application language and add a fallback language in your .env<\/code> file:<\/p>\n\n\n

APP_LOCALE=en\nAPP_FALLBACK_LOCALE=en<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
APP_LOCALE<\/code> defines the default language (English here). APP_FALLBACK_LOCALE<\/code> is used if a translation is missing in the chosen language.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Create Translation Files<\/strong><\/h2>\n\n\n\n
Laravel stores translations under the lang<\/code> directory. Each locale has its own folder. For example, create lang\/en\/messages.php<\/code> and lang\/es\/messages.php<\/code>:<\/p>\n\n\n
\/\/ lang\/en\/messages.php<\/span>\nreturn<\/span> [\n    'welcome'<\/span> => 'Welcome to our application!'<\/span>,\n    'login'<\/span> => 'Login'<\/span>,\n    'register'<\/span> => 'Register'<\/span>,\n];<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
This is the English version. Now create the Spanish version:<\/p>\n\n\n
\/\/ lang\/es\/messages.php<\/span>\nreturn<\/span> [\n    'welcome'<\/span> => '\u00a1Bienvenido a nuestra aplicaci\u00f3n!'<\/span>,\n    'login'<\/span> => 'Iniciar sesi\u00f3n'<\/span>,\n    'register'<\/span> => 'Registrarse'<\/span>,\n];<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Each key should exist in all languages. Laravel automatically looks up the key in the current locale\u2019s file.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Using Translations in Blade Templates<\/strong><\/h2>\n\n\n\n
Use the __()<\/code> helper or @lang<\/code> directive to fetch translations inside your views:<\/p>\n\n\n
<h1>{{ __('messages.welcome'<\/span>) }}<\/h1>\n\n<a href=\"\/login\"<\/span>>@lang('messages.login'<\/span>)<\/a> |\n<a href=\"\/register\"<\/span>>@lang('messages.register'<\/span>)<\/a><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
When the locale is en<\/code>, this outputs English. When es<\/code>, it displays Spanish text. This keeps Blade templates clean and reusable.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Switching Locales in a Controller<\/strong><\/h2>\n\n\n\n
You can set the current locale dynamically in a controller action, for example, when a user chooses a language preference:<\/p>\n\n\n
namespace<\/span> App<\/span>\\Http<\/span>\\Controllers<\/span>;\n\nuse<\/span> Illuminate<\/span>\\Http<\/span>\\Request<\/span>;\nuse<\/span> Illuminate<\/span>\\Support<\/span>\\Facades<\/span>\\App<\/span>;\n\nclass<\/span> LanguageController<\/span> extends<\/span> Controller<\/span>\n<\/span>{\n    public<\/span> function<\/span> switch<\/span>($locale)<\/span>\n    <\/span>{\n        if<\/span> (in_array($locale, ['en'<\/span>, 'es'<\/span>])) {\n            App::setLocale($locale);\n            session(['locale'<\/span> => $locale]);\n        }\n\n        return<\/span> redirect()->back();\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
The app\u2019s locale is updated and stored in the session. Add a route like \/lang\/{locale}<\/code> to switch languages dynamically.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Persisting Locale with Middleware<\/strong><\/h2>\n\n\n\n
Create a middleware that applies the user\u2019s preferred locale on every request:<\/p>\n\n\n
php artisan make:middleware SetLocale<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
Then implement it like this:<\/p>\n\n\n
namespace<\/span> App<\/span>\\Http<\/span>\\Middleware<\/span>;\n\nuse<\/span> Closure<\/span>;\nuse<\/span> Illuminate<\/span>\\Support<\/span>\\Facades<\/span>\\App<\/span>;\n\nclass<\/span> SetLocale<\/span>\n<\/span>{\n    public<\/span> function<\/span> handle<\/span>($request, Closure $next)<\/span>\n    <\/span>{\n        $locale = session('locale'<\/span>, config('app.locale'<\/span>));\n        App::setLocale($locale);\n\n        return<\/span> $next($request);\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Register this middleware in app\/Http\/Kernel.php<\/code>, and Laravel will automatically use the stored session locale for every request.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Building a Language Switcher UI<\/strong><\/h2>\n\n\n\n
Add a simple dropdown in your Blade template to let users pick a language:<\/p>\n\n\n
<form action=\"\/lang\"<\/span> method=\"GET\"<\/span>>\n    <select name=\"locale\"<\/span> onchange=\"this.form.submit()\"<\/span>>\n        <option value=\"en\"<\/span> {{ app()->getLocale() == 'en'<\/span> ? 'selected'<\/span> : ''<\/span> }}>English<\/option>\n        <option value=\"es\"<\/span> {{ app()->getLocale() == 'es'<\/span> ? 'selected'<\/span> : ''<\/span> }}>Espa\u00f1ol<\/option>\n    <\/select>\n<\/form><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
This dropdown reloads the page with the chosen locale applied. You can enhance it with Bootstrap or Tailwind to match your design system.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Using Events for Language Switching<\/strong><\/h2>\n\n\n\n
For audit logs or analytics, trigger an event whenever the user switches their language:<\/p>\n\n\n
\/\/ app\/Events\/LanguageChanged.php<\/span>\nnamespace<\/span> App<\/span>\\Events<\/span>;\n\nuse<\/span> Illuminate<\/span>\\Foundation<\/span>\\Events<\/span>\\Dispatchable<\/span>;\n\nclass<\/span> LanguageChanged<\/span>\n<\/span>{\n    use<\/span> Dispatchable<\/span>;\n\n    public<\/span> $locale;\n\n    public<\/span> function<\/span> __construct<\/span>($locale)<\/span>\n    <\/span>{\n        $this<\/span>->locale = $locale;\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Dispatch the event from your controller when switching locales, and attach listeners to record logs or update persistent user settings.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Wrapping Up<\/strong><\/h2>\n\n\n\n
In this guide, you configured Laravel 12 for multiple languages, created translation files, used translations in Blade, switched locales via controllers and middleware, built a dropdown UI, and fired events for language changes. Multi-language support makes your app accessible to global users and improves overall UX.<\/p>\n\n\n\n
<\/div>\n\n\n\n
FAQ: Multi-Language (i18n) in Laravel<\/strong><\/h2>\n\n\n\n