Laravel Localization: Building Multilingual Applications Easily

Introduction

Laravel is widely known for its simplicity, elegance, and developer-friendly tools. Among its many powerful features, Localization and Pagination stand out when building modern multilingual applications. Imagine building an e-commerce store or a blog where users can browse through pages of content in their native language—Laravel makes this possible with minimal effort.

In this tutorial, we’ll explore:

• How Laravel localization works
• How to configure language files
• How to apply localization to pagination
• Real-world examples of multilingual pagination

Understanding Laravel Localization

Localization in Laravel allows you to present your application in multiple languages without rewriting your entire codebase. Laravel achieves this by storing translations in resources/lang directory, grouped by locale folders.

Default Structure of Language Files

Here’s how a fresh Laravel app’s language structure looks:

resources/
 └── lang/
     └── en/
         └── pagination.php
      

Adding a New Language

To add a new language (e.g., French), create a fr directory:

resources/lang/fr/pagination.php
resources/lang/fr/messages.php
      

Now, you can start filling in French translations for pagination and other messages.

Laravel Pagination Basics

Pagination is essential when you’re dealing with large datasets like blog posts, products, or comments. Laravel provides methods like paginate(), simplePaginate(), and cursorPaginate().

Example: Paginating Blog Posts

$posts = Post::paginate(10);
return view('blog.index', compact('posts'));
      

In your Blade view, display the pagination links:

{{ $posts->links() }}
      

Integrating Pagination with Localization

By default, pagination links (like “Next” and “Previous”) come from Laravel’s pagination.php language file. If you want these terms localized, you must provide translations in your locale files.

Step 1: Editing Pagination Language File

Example: resources/lang/en/pagination.php

return [
    'previous' => '« Previous',
    'next' => 'Next »',
];
      

Step 2: Adding Another Language

Example: resources/lang/fr/pagination.php

return [
    'previous' => '« Précédent',
    'next' => 'Suivant »',
];
      

Step 3: Setting Application Locale

In config/app.php, change default locale:

'locale' => 'fr',
      

Alternatively, you can set it dynamically in a controller:

app()->setLocale('fr');
      

Building a Multilingual Switcher

To make your application user-friendly, add a language switcher. This allows users to toggle between English, French, Spanish, etc.

Controller Example

public function switchLang($lang)
{
    session(['locale' => $lang]);
    return redirect()->back();
}
      

Middleware for Locale

public function handle($request, Closure $next)
{
    if (session()->has('locale')) {
        app()->setLocale(session('locale'));
    }
    return $next($request);
}
      

Blade Example for Dropdown

<select onchange="location = this.value;">
  <option value="{{ url('lang/en') }}">English</option>
  <option value="{{ url('lang/fr') }}">Français</option>
</select>
      

Advanced Example: Multilingual Blog with Pagination

Let’s put it all together with a multilingual blog post listing that supports localized pagination links.

Route Example

Route::get('/{lang}/posts', function($lang) {
    app()->setLocale($lang);
    $posts = App\Models\Post::paginate(5);
    return view('posts.index', compact('posts'));
});
      

Blade View

<h1>{{ __('messages.blog_title') }}</h1>

@foreach($posts as $post)
  <h2>{{ $post->title }}</h2>
  <p>{{ $post->body }}</p>
@endforeach

{{ $posts->links() }}
      

Best Practices for Localization and Pagination

Here are some best practices when dealing with localization and pagination together:

Conclusion

By now, you should have a clear understanding of how to combine Laravel’s localization features with pagination to create multilingual applications. You’ve learned how to configure translation files, paginate results, localize pagination labels, and even build a language switcher.

With these skills, you can make your Laravel applications more accessible, user-friendly, and truly global.