I18n ( Đa ngôn ngữ ) trong Laravel 5

Bài đăng này đã không được cập nhật trong 5 năm

Chào các bạn mình vừa tìm hiểu về chủ để đa ngôn ngữ trong xây dựng ứng dụng ứng dụng web với framwork Larvel hay còn gọi là I18n .Mình đã thực hiện thành công nên muốn chia sẻ với mọi người.
Để tiếp cận được với nhiều khách hàng trên toàn cầu thì việc sử dụng i18n trong website là rất cần thiết. Trong Laravel vấn đề i18n được hỗ trợ và xử lý khá đơn giản. Bài viết này mình sẽ giúp các bạn có thể thực hiện i18n trong trang web của chính mình.

1. Các thiết lập ban đầu

1.1 I18n sử dụng file PHP

Để sử dụng file PHP , Trong thư mục /resources/lang/ thêm các folder chứa các ngôn ngữ mà muốn chuyển đổi ở đây là folder vi và en Ở đây mình tạo file là language.php, cả 2 folder ban đều tạo các file có tên giống nhau :

File /resources/lang/en/language.php

<?php
return [
    'home' => 'HOME PAGE',
    'course' => 'COURSE',
    'schedule' => 'SCHEDULE',
    'news' => 'NEWS',
    'contact' => 'CONTACT',

];

/resources/lang/vi/language.php

<?php
return [
    'home' => 'TRANG CHỦ',
    'course' => 'KHÓA HỌC',
    'schedule' => 'LỊCH KHAI GIẢNG',
    'news' => 'TIN TỨC',
    'contact' => 'LIÊN HỆ',

];

Cú pháp để sử dụng trong file view sẽ là: {{ trans('language.home') }}


<li class="active"> <a href="/home">{{ trans('language.home') }}</a> </li>

1.2 I18n sử dụng file Json

Khi sử dụng với file thì chúng ta sẽ tạo ra 2 folder mới, nhưng khi sử dụng file json thì không cần. Chỉ cần tạo ra 2 file json ngay tại folder sources/lang.

/resources
   /lang
       en.json
       vi.json

/resources/lang/vi.json

{
   "home" : "TRANG CHỦ",
    "course" : "CÁC KHÓA HỌC",
    "course_detail" : "CHI TIẾT KHÓA HỌC",
    "schedule" : "LỊCH KHAI GIẢNG",
    "news" : "TIN TỨC",
    "news detail" : "CHI TIẾT TIN TỨC",
    "contact" : "LIÊN HỆ",
    "language" : "Ngôn Ngữ"
    }

/resources/lang/en.js

{
   "home" : "HOME PAGE",
    "course" : "COURSES",
    "course_detail" : "COURSE DETAIL",
    "schedule" : "SCHEDULE",
    "news" : "NEWS",
    "news detail" : "NEWS DETAIL",
    "contact" : "CONTACT",
    "language" : "Language"
    }

Cú pháp dùng trong file view sẽ là :

{{ __('home') }}
{{ __('home, :name', ['name' => 'Awesome Academy']) }}

Khi đó ở file view sẽ có dạng như này:

<li class="active"> <a href="/home">{{ __('home') }}</a> </li>

2. Sử dụng đa ngôn ngữ (I18n)

Trước tiên thì ta nên cấu hình ngôn ngữ mặc định của website trong file config/app.php

'locale' => 'en', //ngôn ngữ mặc định
'fallback_locale' => 'en', // được sử dụng khi không tìm thấy config locale.

Ta cấu hình các thông số trên cho phù hợp và với cách 1 thì để tên folder, còn với cách 2 thì để tên file json. Ví dụ ở trên mình sử dụng file json

2.1 Sử dụng session và middleware

Session để lưu ngôn ngữ hiện tại đang được chọn, middleware để xử lý lựa chọn của người dùng.

Tiếp theo, tạo 1 route để xử lý thay đổi.

Route::get('change-language/{language}', 'HomeController@changeLanguage')->name('user.change-language');

Đặt 2 link vào đường dẫn tương ứng :

<a href="{!! route('user.change-language', ['en']) !!}">English</a>
     <a href="{!! route('user.change-language', ['vi']) !!}">Vietnam</a>

Tạo ra một file changeLanguagecontroller.php, có thể tạo với lệnh php artisan make:controller changeLanguageController

Thay đổi nội dung bên trong như sau :

public function changeLanguage($language)
{
    \Session::put('lang', $language);

    return redirect()->back();
}

Tiếp theo ta sẽ tạo middware để xử lý cho ứng dụng theo ngôn ngữ người dùng lựa chọn được lưu trong Session. Chạy lệnh sau để tạo ra file Locale php artisan make:middleware Locale.

Sau khi chạy xong sẽ tạo ra một file trong app/Http/Middleware/Locale.phpNội dung file này như sau :

public function handle($request, Closure $next)
    {
        if($language=$request->session()->get('lang')){
            \App::setLocale($language);
        }

    return $next($request);
    }

Trong đây sẽ tạo ra một mảng các ngôn ngữ người dùng. Nó sẽ kiểm tra ngôn ngữ đang được lựa chọn lưu ở sesion và thực hiện set lại giá trị tương ứng qua hàm \App::setLocale($language);
Để có thể chạy được mỗi khi request ta thêm vào app\Http\kernel.php .

protected $middlewareGroups = [
        'web' => [
            ....
            \App\Http\Middleware\VerifyCsrfToken::class,
            \Illuminate\Routing\Middleware\SubstituteBindings::class,
            \App\Http\Middleware\Locale::class // Thêm ở đây
        ],

Tiếp tục thêm vào $routeMiddleware trong file app\Http\kernel.php

protected $routeMiddleware = [
        ...
        'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
        'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
        'locale' => \App\Http\Middleware\Locale::class,// thêm ở đây
    ];

Cuối cùng để toàn bộ route được xử lý qua middleware này, ta đặt nó như sau :

Route::group(['middleware' => 'locale'], function() {
    Route::get('change-language/{language}', 'HomeController@changeLanguage')
        ->name('user.change-language');
});