Hướng dẫn php multilanguage - đa ngôn ngữ php

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

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

  8 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à

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

  9 và

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

  0 để 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à

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

1, 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.

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

2

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

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

3

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

Để sử dụng ta có hàm

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

4, và trong file view blade bạn sẽ gọi

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

5, cụ thể là

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

6, khi đó sẽ hiển thị ra người dùng là

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

7 hoặc

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

8 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ử

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

  9 trước tên tham số, ta sẽ làm như thế này:

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

  2

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
];

Và để sử dụng thì ta làm như thế này

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
];

1, khi đó sẽ người dùng sẽ thấy được

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
];

2.

• Ta có thể tạo ra các câu số nhiều bằng cách sử dụng toán tử

  
  return [
      'welcome' => 'Welcome to Website!',
      'hello' => 'Hello, :name',
  ];
  

  3 như sau.

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

  2

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

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
];

5 với số lượng là 1 thì trả về

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
];

6, còn với số lượng lớn hơn 1 thì trả về

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
];

7. Hoặc ta có thể tùy chỉnh số lượng cho phù hợp với cách dưới đây:

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

2

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

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
];

9 ngay tại folder

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

0 như trên.

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

1

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

Cuối file ko có dấu

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

2 để đúng với cú pháp của file

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

3. Cách dùng thì ta sử dụng hàm

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

4, đâ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

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

5

    '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

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

6, còn với cách 2 thì các ta để tên file

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

3.

2.1 Sử dụng 'Welcome to Website!', 'hello' => 'Hello, :name', 'apple' => 'There is one apple|There are many apples', ]; 8 và 'Welcome to Website!', 'hello' => 'Hello, :name', 'apple' => 'There is one apple|There are many apples', ]; 9

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ữ.

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

0

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

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

1

Trong HomeControler tại method

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',
];

0 :

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

2

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

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. Một file đã được sinh ra tại

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',
];

2, vào file này và chỉnh sửa như sau tại method

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',
];

3

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

3

Và để sử dụng

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

9 thì ta cần khai báo trong

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',
];

5

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

4

Và bước cuối cùng để toàn bộ route được xử lý qua

return [
    'welcome' => 'Welcome to Website!',
    'hello' => 'Hello, :name',
    'apple' => 'There is one apple|There are many apples',
];

9 này, và mình làm như sau tại

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',
];

7

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

5

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ó

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',
];

8 và

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',
];

9, ta sẽ tạo route như sau

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

6

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

/resources
    /lang
        en.json
        vi.json

0 trong ứng dụng.

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

7

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

/resources
    /lang
        en.json
        vi.json

0.

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.