Laravel本地化模組的學習

這篇文章主要給大家介紹了關於Laravel學習教程之本地化模組的相關資料，文中通過範例程式碼給大家介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們一起學習學習吧。

前言

本文主要給大家介紹了關於Laravel本地化模組的相關內容，分享出來供大家參考學習，話不多說了，來一起看看詳細的介紹吧。

本文是基於Laravel 5.4版本的本地化模組代碼進行分析書寫；

模組組成

展示了本地化模組各個檔案的關係，並進行簡要說明；

• TranslationServiceProvider
  本地化模組的服務提供者，既是一個模組的入口，也是與IOC容器互動的中心；註冊翻譯器執行個體translation.loader，註冊翻譯管理執行個體translator，並聲明消極式載入服務；

• Translator
  翻譯管理類；

• MessageSelector
  訊息過濾器，通過判斷複數值來選擇合適的訊息；比如訊息內容是這樣的{0}沒有|[1,19]一些|[20,*]很多，我們傳的數字是 18，那麼最後選擇的訊息就是"一些"；

• LoaderInterface
  翻譯器介面；聲明了三個方法load，addNamespace，namespaces；

• FileLoader
  繼承了LoaderInterface，從檔案擷取本地化資源資料；

• ArrayLoader
  繼承了LoaderInterface，在記憶體用數組維護本地化資源資料；
  

配置說明

在config配置目錄下和本模組有關的參數只有app.php檔案中的locale和fallback_locale；

locale表示預設本地化語言是什麼，這樣會優先從該語言資來源目錄中擷取翻譯（轉換）內容；
如果locale表示的語言不存在，則使用fallback_locale這個備用語言；

筆者的locale是zh_CN，fallback_locale是en；

功能介紹

全域的語言資來源目錄在項目的resources/lang下，每個子目錄分別以語言為名，比如en、zh_CN等；

另外一些子目錄是命名空間為名，是對第三方載入庫資源檔的補充替換；

有可能還存在en.json、zh_CN這類Json檔案，項目有時候會從Json檔案讀取資料，這些資料均來自於這個已存在的Json檔案；

翻譯全域語言資源

筆者的語言資源根目錄resources/lang下有zh_CN/validation.php，內容如下

<?phpreturn [ 'accepted'  => ':attribute 必須接受。', 'active_url'  => ':attribute 不是一個有效網址。', 'after'  => ':attribute 必須是一個在 :date 之後的日期。', ......];

通過調用代碼

app('translator')->trans('validation.accepted', ['attribute' => '使用者名稱'])

或者全域協助函數trans

trans('validation.accepted', ['attribute' => '使用者名稱'])

輸出 "使用者名稱 必須接受。"；

調用過程如下：

• 解析鍵名：將鍵名進行解析成數組 ($namespace = '*', $group = 'validation', $item = 'accepted')；namespace為*，表示在全域命名空間下；group，組，其實就是檔案名稱，一個檔案為一組；item是元素的意思；

• 擷取語言數組： 這裡的$locale為null，所以返回的是預設與備用語言群組成的數組，也就是['zh_CN', 'en']；並進行for迴圈，進入語言資來源目錄中尋找需要的元素值，如果找到，即 break；

• 載入資源：因為命名空間為*，所以定位資源根目錄為resources/lang；語言為zh_CN，所以子目錄為zh_CN；group名為validation，這時就把resources/lang/zh_CN/validation.php檔案中的所有內容都載入進記憶體中，並進行儲存 $this->loaded[$namespace][$group][$locale] = $lines;

• 擷取資源，並替換參數：通過Arr::get方法從$this->loaded[$namespace][$group][$locale]中擷取元素值:attribute 必須接受。；此時，參數數組為不空，迴圈替換，得到結果"使用者名稱 必須接受。"；
  

翻譯帶命名空間的語言資源

筆者在語言資源根目錄resource/lang下，建立vendor/Faker/Provider/zh_CN/Internet.php檔案，內容如下：

<?phpreturn [ 'message' => 'hello, Faker/Provider', ......];

同時，手動在Translator中註冊第三方外掛程式（也就是帶命名空間）的資源根目錄位置；

app('translator')->addNamespace('Faker/Provider', base_path('vendor/xx/resource/lang'))

現在，擷取帶命名空間的資源；

trans('Faker/Provider::Internet.message');

輸出 'hello, Faker/Provider'；

調用過程如下：

• 解析鍵名：將鍵名進行解析成數組 ($namespace = 'Faker/Provider', $group = 'Internet', $item = 'message')；

• 擷取語言數組： 這裡的$locale為null，所以返回的是預設與備用語言群組成的數組，也就是['zh_CN', 'en']；並進行for迴圈，進入語言資來源目錄中尋找需要的元素值，如果找到，即 break；

• 載入資源：因為命名空間為Faker/Provider，此時會分兩步；第一步讀取第三方外掛程式資產庫下的資訊，這時讀取命名空間註冊的根目錄為base_path('vendor/xx/resource/lang')，就讀取base_path('vendor/xx/resource/lang')/zh_CN/Internet.php內容，檔案不存在，返回空數組；第二步讀取全域語言資源，進行補充，也就是讀取base_path('resource/lang/vendor/Faker/Provider')/zh_CN/Internet.php; 最後進行儲存 $this->loaded[$namespace][$group][$locale] = $lines;

• 擷取資源，並替換參數：通過Arr::get方法從$this->loaded[$namespace][$group][$locale]中擷取元素值" hello, Faker/Provider"；此時，參數數組為空白，直接返回結果 "hello, Faker/Provider"；
  

翻譯Json檔案中的資源

筆者在語言資源根目錄resource/lang下，建立zh_CN.json檔案，內容如下：

{ "name": "zh_CN.json", "place": "../resources/lang/zh_CN.json"}

現在，擷取Json檔案中的name值；

trans('*.name')

輸出 "zh_CN.json"；

調用過程如下：

• 解析鍵名：將鍵名進行解析成數組 ($namespace = '*', $group = '*', $item = 'name')；

• 擷取語言數組： 這裡的$locale為null，所以返回的是預設與備用語言群組成的數組，也就是['zh_CN', 'en']；並進行for迴圈，進入語言資來源目錄中尋找需要的元素值，如果找到，即 break；

• 載入資源：因為命名空間為*，且組也為*，這時會讀取語言根目錄下，名字為語言值的Json檔案；此時會讀取resource/lang/zh_CN.json，將讀取的內容，進行儲存 $this->loaded[$namespace][$group][$locale] = $lines;

• 擷取資源，並替換參數：通過Arr::get方法從$this->loaded[$namespace][$group][$locale]中擷取元素值"zh_CN.json"；此時，參數數組為空白，直接返回結果 "zh_CN.json"；

運行時綁定資源

資源的內容除了放在檔案中，用到的時候在讀取，也可以在項目運行時，存放；

以resources/lang/zh_CN/validation.php為例，現在想要在運行時，給這個組添加一個新的元素叫 extra，需要指定放在哪個語言下，可以這樣寫

app('translator')->addLines(array('validation.extra' => '測試添加額外資料'), 'zh_CN');

現在可以擷取這個新添加的元素值

trans('validation.extra')

複數資源過濾

筆者通過 運行時綁定資源 添加一條翻譯內容：

app('translator')->addLines(array('validation.extra' => '{0}沒有|[1,19]一些|[20,*]很多'), 'zh_CN');

如果通過trans('validation.extra') ，擷取的就是整條翻譯內容，不是我們所期望的；用choice方法：

app('translator')->choice('validation.extra', 0) 得到 沒有；

app('translator')->choice('validation.extra', 18) 得到 一些；

app('translator')->choice('validation.extra', 20) 得到 很多；

可以將app('translator')->choice(...)簡寫成全域協助函數trans_choice(...)；

以上就是本文的全部內容，希望對大家的學習有所協助，更多相關內容請關注topic.alibabacloud.com！