+35

Đa ngôn ngữ (i18n) trong Laravel

Các website ngày nay muốn tiếp cận với nhiều loại khách hàng thì đều cần phải sử dụng đa ngôn ngữ (i18n). Với những ai sử dụng Laravel cho việc phát triển website thì vấn đề i18n được hỗ trợ và xử lý rất đơn giản. Bài viết này mình sẽ giới thiệu đến các bạn một số cách để xử lý i18n trong Laravel.

1. Cách thiết lập.

1.1 Sử dụng file php

  • Trong thư mục /resources/lang/ ta thêm các folder chứa các ngôn ngữ mà muốn chuyển đổi, như ví dụ dưới đây mình sẽ tạo 2 folder là envi để chứa ngôn ngữ của Tiếng Anh và Tiếng Việt.
/resources
    /lang
        /en
            messages.php
        /vi
            messages.php

Trong các folder ta tạo các file php và đặt tên sao cho phù hợp, như trên giả sử mình tạo file là message.php, trong cả 2 folder ban đều tạo các file giống nhau và nội dung trong các file mình tạo như sau. /resources/lang/en/message.php

<?php
return [
    'welcome' => 'Welcome to Website!',
];

/resources/lang/vi/message.php

<?php
return [
    'welcome' => 'Chào mừng bạn đến với Website!',
];

Để sử dụng ta có hàm trans(), và trong file view blade bạn sẽ gọi {{ trans('<file_name>.<keywork>') }}, cụ thể là {{ trans('message.welcome') }}, khi đó sẽ hiển thị ra người dùng là Welcome to Website! hoặc Chào mừng bạn đến với Website!' tùy theo cấu hình hiện tại. Để thay đổi cấu hình ngôn ngữ hiển thị mình sẽ hướng dẫn ở phần duới của bài viết này.

  • Đôi khi ta sẽ muốn truyền tham số lấy từ database vào, để truyền tham số thì ta sẽ sử dụng toán tử : trước tên tham số, ta sẽ làm như thế này: /resources/lang/en/message.php
<?php
return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
];

Và để sử dụng thì ta làm như thế này {{ trans('messages.hello', ['name' => 'My Name']) }}, khi đó sẽ người dùng sẽ thấy được Hello, My Name.

  • Ta có thể tạo ra các câu số nhiều bằng cách sử dụng toán tử | như sau. /resources/lang/en/message.php
<?php
return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

Khi gọi thì ta gọi hàm trans_choice('messages.apples', 10) với số lượng là 1 thì trả về There is one apple, còn với số lượng lớn hơn 1 thì trả về There are many apples. Hoặc ta có thể tùy chỉnh số lượng cho phù hợp với cách dưới đây: /resources/lang/en/message.php

<?php
return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
    'apples' => '{0} There are none|[1,19] There are some|[20,Inf] There are many',
];

1.2 Sử dụng file json

Khi ứng dụng của ta lớn, phải sử dụng rất nhiều đến đa ngôn ngữ, thì việc tạo các file với các keyword ngắn và viết liền nhiều khi có thể gây nhầm lẫn hoặc khó nhớ. Và từ phiên bản bản 5.4 Laravel bổ sung thêm một cách để làm ứng dụng đa ngôn ngữ. Mình nghĩ không hẳn tự nhiên những người phát triển lại bổ sung thêm cách này, thật sự nó có thể tạo cho bạn sự thoải mái khi sử dụng. Như cách ở trên thì ta cần tạo các file và trong mỗi file phải tạo các keyword ngắn và viết liền, khi ứng dụng nhiều dần các keyword đọc rất khó hiểu và khi tạo keyword ta lại phải đau đầu nghĩ xem tạo keyword như thế nào cho phù hợp. Với cách này thì ta có thể dùng cả đoạn văn làm keyword, văn bản đầy đủ có thể làm ứng dụng của bạn dễ đọc, chứ không cần phải vào file tìm xem keyword kia được viết thay thế cho từ nào. Mình sẽ hướng dẫn làm với cách này như sau: Ta tạo file json tại vị trí như sau:

/resources
    /lang
        en.json
        vi.json

Lưu ý một chút là cách dùng file php thì ta cần để trong folder, còn với cách này thì ta sẽ để file .json ngay tại folder /resources/lang như trên. /resources/lang/en.json

{
    'Welcome to Website!' => 'Welcome to Website!',
    'Welcome to Website, :name' => 'Welcome to Website, :name'
}

Cuối file ko có dấu , để đúng với cú pháp của file json. Cách dùng thì ta sử dụng hàm __(), đây là 2 dấu gạch dưới, mình đã từng làm với Magento và cũng có cú pháp tương tự khi i18n. Ví dụ:

{{ __('Welcome to Website!') }}
{{ __('Welcome to Website, :name', ['name' => 'My Name']) }}

Mình cố tình để tham số vào phần keyword để khi đọc thì ta có thể biết ngay cần bổ sung gì, hoặc nếu không thích thì bạn có thể bỏ tham số bên keyword đi.

2. Website thay đổi ngôn ngữ theo người dùng

Bên trên mình đã giới thiệu 2 cách để sử dụng i18n trong Laravel, và đây mình sẽ tiếp tục hướng dẫn một số cách để website thay đổi ngôn ngữ theo ý người dùng. 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ì các bạn để tên folder, còn với cách 2 thì các ta để tên file json.

2.1 Sử dụng sessionmiddleware

Session để lưu ngôn ngữ hiện tại khách đang chọn, middleware để tiền xử lý cho website của bạn thay đổi ngôn ngữ theo lựa chọn của người dùng. Tạo 1 route xử lý thay đổi ngôn ngữ.

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

Đặt 2 link sau vào vị trí phù hợp trên website

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

Trong HomeControler tại method changeLanguage :

public function changeLanguage($language)
{
    \Session::put('website_language', $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 trong ứng dụng Laravel php artisan make:middleware Locale. Một file đã được sinh ra tại app/Http/Middleware/Locale.php, vào file này và chỉnh sửa như sau tại method handle

public function handle($request, Closure $next)
{
    $language = \Session::get('website_language', config('app.locale'));
    // Lấy dữ liệu lưu trong Session, không có thì trả về default lấy trong config

    config(['app.locale' => $language]);
    // Chuyển ứng dụng sang ngôn ngữ được chọn

    return $next($request);
}

Và để sử dụng middleware thì ta cần khai báo trong app/Http/Kernel.php

protected $routeMiddleware = [
    'auth' => \Illuminate\Auth\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'bindings' => \Illuminate\Routing\Middleware\SubstituteBindings::class,
    'can' => \Illuminate\Auth\Middleware\Authorize::class,
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
    'locale' => \App\Http\Middleware\Locale::class, //Thêm vào dòng này
];

Và bước cuối cùng để toàn bộ route được xử lý qua middleware này, và mình làm như sau tại routes/web.php

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

Thế là xong rồi đó, bạn nên tùy chỉnh một số chỗ cho phù hợp với ứng dụng của bạn.

2.2 Sử dụng subdomain

Với cách này thì ta cần tạo subdomain cho từng ngôn ngữ sử dụng, giả sử mình có vi.i18n.deven.i18n.dev, ta sẽ tạo route như sau

Route::group(['domain' => '{language}.i18n.dev'], function ($language) {
    config(['app.locale' => $language]); //đặt dòng này ở đầu
    
    //Toàn bộ các route khác đặt ở đây.
});

Và chỉ đơn giản cho người dùng truy cập vào trang ứng với ngôn ngữ họ muốn sử dụng.

2.3 Sử dụng trên url

Kiểu này cũng khá giống kiểu subdomain, bạn sẽ thêm ngôn ngữ vào trước toàn bộ các url trong ứng dụng.

Route::group(['prefix' => '{language}'], function ($language) {
    config(['app.locale' => $language]); //đặt dòng này ở đầu
    
    //Toàn bộ các route khác đặt ở đây.
});

Với cách này ta phải truyền thêm ngôn ngữ vào toàn bộ các url.

Kết

Thế là hết rồi, hy vọng bạn có thể áp dụng được bài viết này vào ứng dụng của bạn.


All rights reserved

Bình luận

Đăng nhập để bình luận
Avatar
@letien524
thg 4 23, 2019 8:52 SA
{
    'Welcome to Website!' => 'Welcome to Website!',
    'Welcome to Website, :name' => 'Welcome to Website, :name'
}

Đúng cấu trúc: nháy đơn chuyển thành nháy kép, => chuyển :

{
    "Welcome to Website!" :  "Welcome to Website!",
    "Welcome to Website, :name" : "Welcome to Website, :name"
}
Avatar
@trustephen
thg 8 19, 2019 7:30 SA
Avatar
@Heongost
thg 8 19, 2019 9:22 SA

Anh ơi, nếu dữ liệu thay đổi bởi người dùng thì dịch như thế nào ạ? Em thấy cái này chỉ dịch dữ liệu tĩnh thôi ạ. Cái ví dụ của anh là 'Hello, My Name'. Nếu người dùng nhập vào là {{ trans('messages.hello', ['name' => 'táo']) }} thì nó sẽ thành 'Hello, táo' chứ hổng thể thành 'Hello, apple' được anh ơi 😦

Avatar
@dinh.van.tai
thg 8 21, 2019 4:36 SA

Như em nói thì nó sẽ là "Xin chào, táo" hoặc "Hello, táo", còn chữ "táo" em truyền vào sao thì nó đưa vào thay thế nguyên như vậy. Còn em muốn thay đổi chứ "táo" thành "apple" thì sẽ code nhiều hơn rất nhiều, thường chứ "táo" sẽ lấy từ DB ra, như thế em cần thêm phần translate DB, đây là bài toàn khác và cồng kềnh hơn rất nhiều em nhé.

Avatar
@Heongost
thg 8 22, 2019 7:18 SA

Vậy là để dịch qua ngôn ngữ khác phải translate DB hẳn anh? Tại em đang làm một website có phần dịch ngôn ngữ, mà website này gồm có slider, menu, tin tức,... đều đổ dữ liệu từ database ra nên đang lo là không biết translate thế nào ạ? (Em chỉ dich từ tiếng Việt sang tiếng Anh thôi). 😦

Avatar
@ngoclanbaby86
thg 4 29, 2020 12:22 CH

Bạn cần lưu các bản dịch vào DB với các bảng mà bạn cần dịch, tương đương sẽ có gán các loại ngôn ngữ tương ứng để khi gọi ra nó sẽ khớp với phần Language của bài này.

Avatar
@VuThiHuong
thg 11 12, 2019 3:01 SA

I get error is: "Class locale does not exist". Can you support for me?

Avatar
@simple1805
thg 11 12, 2019 11:06 SA

Please run

php artisan config:clear
Avatar
@phatntt1999
thg 6 21, 2021 4:49 CH
Avatar
@phatntt1999
thg 6 21, 2021 4:50 CH

Thank anh @dinh.van.tai , bài viết rất hữu ích. Tuy nhiên chỗ file Kernel.php, chỉ khai báo trong $routeMiddleware thì em chạy hoài vẫn không dịch được. Ngồi mò một chặp thì phải khai báo thêm trong $middlewareGroups(chỗ phần web) nữa thì mới chạy ok.

Cho những bạn nào làm theo hướng dẫn mà không chạy được thì thử cách này. Sẵn tiện anh Dinh Tai giải thích hộ em chỗ này nếu có thể ạ! Em cảm ơn nhiều ^^

Avatar
@dinh.van.tai
thg 6 22, 2021 5:52 SA

Cảm ơn góp ý của bạn, mình cần lưu ý một điều là bất kỳ route nào cũng đều cần chạy qua middleware này thì nó mới hoạt động, bạn đặt vào vị trí "$middlewareGroups(chỗ phần web)" thì middleware này sẽ chạy cho toàn bộ cho các route ở web.php, một phương án hay đấy. Còn như bài viết thì bạn cần đặt toàn bộ các route khác vào trong group như trên bài nhá, có thể bạn đang đặt ở ngoài rồi.

Avatar
@phatntt1999
thg 6 24, 2021 3:40 SA

@dinh.van.tai À thì ra là vậy. Em hiểu ý anh rồi, đúng như a nói, em bỏ sang $middlewareGroups chạy cho toàn bộ cho các route ở web.php thì nó hoạt động ok. Mà không hiểu sao em đặt vào $routeMiddleware là nó không hoạt động anh ạ 😦(( Không biết là có đang miss chỗ nào không. Em xóa route middleware trong Kernel thì hệ thống nó báo lỗi không tìm thấy middleware locale, tức là nó vẫn link tới. Thế mà không hiểu sao chạy lên nó lại không dịch.

Avatar
+35
Viblo
Hãy đăng ký một tài khoản Viblo để nhận được nhiều bài viết thú vị hơn.
Đăng kí