《PHP實(shí)戰(zhàn)：Laravel學(xué)習(xí)教程之本地化模塊》要點(diǎn)：
本文介紹了PHP實(shí)戰(zhàn)：Laravel學(xué)習(xí)教程之本地化模塊，希望對(duì)您有用。如果有疑問(wèn)，可以聯(lián)系我們。

前言PHP編程

本文主要給大家介紹了關(guān)于Laravel本地化模塊的相關(guān)內(nèi)容,分享出來(lái)供大家參考學(xué)習(xí),話不多說(shuō)了,來(lái)一起看看詳細(xì)的介紹吧.PHP編程

本文是基于Laravel 5.4版本的本地化模塊代碼進(jìn)行分析書(shū)寫(xiě)；PHP編程

模塊組成
PHP編程

下圖展示了本地化模塊各個(gè)文件的關(guān)系,并進(jìn)行簡(jiǎn)要說(shuō)明；PHP編程

PHP編程

• TranslationServiceProvider
  本地化模塊的服務(wù)提供者,既是一個(gè)模塊的入口,也是與IOC容器交互的中心；注冊(cè)翻譯器實(shí)例translation.loader,注冊(cè)翻譯管理實(shí)例translator,并聲明延遲加載服務(wù)；
• Translator
  翻譯管理類；
• MessageSelector
  消息過(guò)濾器,通過(guò)判斷復(fù)數(shù)值來(lái)選擇合適的消息；比如消息內(nèi)容是這樣的{0}沒(méi)有|[1,19]一些|[20,*]很多,我們傳的數(shù)字是 18,那么最后選擇的消息就是"一些"；
• LoaderInterface
  翻譯器接口；聲明了三個(gè)方法load,addNamespace,namespaces；
• FileLoader
  繼承了LoaderInterface,從文件獲取本地化資源數(shù)據(jù)；
• ArrayLoader
  繼承了LoaderInterface,在內(nèi)存用數(shù)組維護(hù)本地化資源數(shù)據(jù)；
  

配置說(shuō)明
PHP編程

在config配置目錄下和本模塊有關(guān)的參數(shù)只有app.php文件中的locale和fallback_locale；PHP編程

locale表示默認(rèn)本地化語(yǔ)言是什么,這樣會(huì)優(yōu)先從該語(yǔ)言資源目錄中獲取翻譯(轉(zhuǎn)換)內(nèi)容；
如果locale表示的語(yǔ)言不存在,則使用fallback_locale這個(gè)備用語(yǔ)言；PHP編程

筆者的locale是zh_CN,fallback_locale是en；PHP編程

功能介紹
PHP編程

全局的語(yǔ)言資源目錄在項(xiàng)目的resources/lang下,每個(gè)子目錄分別以語(yǔ)言為名,比如en、zh_CN等；PHP編程

另外一些子目錄是命名空間為名,是對(duì)第三方加載庫(kù)資源文件的補(bǔ)充替換；PHP編程

有可能還存在en.json、zh_CN這類Json文件,項(xiàng)目有時(shí)候會(huì)從Json文件讀取數(shù)據(jù),這些數(shù)據(jù)均來(lái)自于這個(gè)已存在的Json文件；PHP編程

翻譯全局語(yǔ)言資源
PHP編程

筆者的語(yǔ)言資源根目錄resources/lang下有zh_CN/validation.php,內(nèi)容如下PHP編程

<?php
return [
 'accepted'  => ':attribute 必須接受.',
 'active_url'  => ':attribute 不是一個(gè)有效的網(wǎng)址.',
 'after'  => ':attribute 必須是一個(gè)在 :date 之后的日期.',
 ......
];

通過(guò)調(diào)用代碼PHP編程

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

或者全局幫助函數(shù)transPHP編程

trans('validation.accepted', ['attribute' => '用戶名'])

輸出 "用戶名 必須接受."；PHP編程

調(diào)用過(guò)程如下：PHP編程

• 解析鍵名：將鍵名進(jìn)行解析成數(shù)組 ($namespace = '*', $group = 'validation', $item = 'accepted')；namespace為*,表示在全局命名空間下；group,組,其實(shí)就是文件名,一個(gè)文件為一組；item是元素的意思；
• 獲取語(yǔ)言數(shù)組： 這里的$locale為null,所以返回的是默認(rèn)與備用語(yǔ)言組成的數(shù)組,也就是['zh_CN', 'en']；并進(jìn)行for循環(huán),進(jìn)入語(yǔ)言資源目錄中尋找需要的元素值,如果找到,即 break；
• 加載資源：因?yàn)槊臻g為*,所以定位資源根目錄為resources/lang；語(yǔ)言為zh_CN,所以子目錄為zh_CN；group名為validation,這時(shí)就把resources/lang/zh_CN/validation.php文件中的所有內(nèi)容都加載進(jìn)內(nèi)存中,并進(jìn)行保存 $this->loaded[$namespace][$group][$locale] = $lines;
• 獲取資源,并替換參數(shù)：通過(guò)Arr::get方法從$this->loaded[$namespace][$group][$locale]中獲取元素值:attribute 必須接受.；此時(shí),參數(shù)數(shù)組為不空,循環(huán)替換,得到結(jié)果"用戶名 必須接受."；
  

翻譯帶命名空間的語(yǔ)言資源
PHP編程

筆者在語(yǔ)言資源根目錄resource/lang下,創(chuàng)建vendor/Faker/Provider/zh_CN/Internet.php文件,內(nèi)容如下：PHP編程

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

同時(shí),手動(dòng)在Translator中注冊(cè)第三方插件(也就是帶命名空間)的資源根目錄位置；PHP編程

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

現(xiàn)在,獲取帶命名空間的資源；PHP編程

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

輸出 'hello, Faker/Provider'；PHP編程

調(diào)用過(guò)程如下：PHP編程

• 解析鍵名：將鍵名進(jìn)行解析成數(shù)組 ($namespace = 'Faker/Provider', $group = 'Internet', $item = 'message')；
• 獲取語(yǔ)言數(shù)組： 這里的$locale為null,所以返回的是默認(rèn)與備用語(yǔ)言組成的數(shù)組,也就是['zh_CN', 'en']；并進(jìn)行for循環(huán),進(jìn)入語(yǔ)言資源目錄中尋找需要的元素值,如果找到,即 break；
• 加載資源：因?yàn)槊臻g為Faker/Provider,此時(shí)會(huì)分兩步；第一步讀取第三方插件資源庫(kù)下的信息,這時(shí)讀取命名空間注冊(cè)的根目錄為base_path('vendor/xx/resource/lang'),就讀取base_path('vendor/xx/resource/lang')/zh_CN/Internet.php內(nèi)容,文件不存在,返回空數(shù)組；第二步讀取全局語(yǔ)言資源,進(jìn)行補(bǔ)充,也就是讀取base_path('resource/lang/vendor/Faker/Provider')/zh_CN/Internet.php; 最后進(jìn)行保存 $this->loaded[$namespace][$group][$locale] = $lines;
• 獲取資源,并替換參數(shù)：通過(guò)Arr::get方法從$this->loaded[$namespace][$group][$locale]中獲取元素值" hello, Faker/Provider"；此時(shí),參數(shù)數(shù)組為空,直接返回結(jié)果 "hello, Faker/Provider"；
  

翻譯Json文件中的資源
PHP編程

筆者在語(yǔ)言資源根目錄resource/lang下,創(chuàng)建zh_CN.json文件,內(nèi)容如下：PHP編程

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

現(xiàn)在,獲取Json文件中的name值；PHP編程

trans('*.name')

輸出 "zh_CN.json"；PHP編程

調(diào)用過(guò)程如下：PHP編程

• 解析鍵名：將鍵名進(jìn)行解析成數(shù)組 ($namespace = '*', $group = '*', $item = 'name')；
• 獲取語(yǔ)言數(shù)組： 這里的$locale為null,所以返回的是默認(rèn)與備用語(yǔ)言組成的數(shù)組,也就是['zh_CN', 'en']；并進(jìn)行for循環(huán),進(jìn)入語(yǔ)言資源目錄中尋找需要的元素值,如果找到,即 break；
• 加載資源：因?yàn)槊臻g為*,且組也為*,這時(shí)會(huì)讀取語(yǔ)言根目錄下,名字為語(yǔ)言值的Json文件；此時(shí)會(huì)讀取resource/lang/zh_CN.json,將讀取的內(nèi)容,進(jìn)行保存 $this->loaded[$namespace][$group][$locale] = $lines;
• 獲取資源,并替換參數(shù)：通過(guò)Arr::get方法從$this->loaded[$namespace][$group][$locale]中獲取元素值"zh_CN.json"；此時(shí),參數(shù)數(shù)組為空,直接返回結(jié)果 "zh_CN.json"；

運(yùn)行時(shí)綁定資源
PHP編程

資源的內(nèi)容除了放在文件中,用到的時(shí)候在讀取,也可以在項(xiàng)目運(yùn)行時(shí),存放；
PHP編程

以resources/lang/zh_CN/validation.php為例,現(xiàn)在想要在運(yùn)行時(shí),給這個(gè)組添加一個(gè)新的元素叫 extra,需要指定放在哪個(gè)語(yǔ)言下,可以這樣寫(xiě)PHP編程

app('translator')->addLines(array('validation.extra' => '測(cè)試添加額外數(shù)據(jù)'), 'zh_CN');

現(xiàn)在可以獲取這個(gè)新添加的元素值PHP編程

trans('validation.extra')

復(fù)數(shù)資源過(guò)濾
PHP編程

筆者通過(guò) 運(yùn)行時(shí)綁定資源 添加一條翻譯內(nèi)容：PHP編程

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

如果通過(guò)trans('validation.extra') ,獲取的就是整條翻譯內(nèi)容,不是我們所期望的；用choice方法：PHP編程

app('translator')->choice('validation.extra', 0) 得到 沒(méi)有；
PHP編程

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

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

可以將app('translator')->choice(...)簡(jiǎn)寫(xiě)成全局幫助函數(shù)trans_choice(...)；PHP編程

總結(jié)PHP編程

以上就是這篇文章的全部?jī)?nèi)容了,希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作能帶來(lái)一定的幫助,如果有疑問(wèn)大家可以留言交流,謝謝大家對(duì)腳本之家的支持.PHP編程

轉(zhuǎn)載請(qǐng)注明本頁(yè)網(wǎng)址：
http://www.fzlkiss.com/jiaocheng/277.html