本地化 · laravel 5.4

<article><h1>Laravel 的本地化功能</h1><ul><li><a href="#introduction">簡介</a></li><li><a href="#defining-translation-strings">定義翻譯語句</a><ul><li><a href="#using-short-keys">使用短鍵</a></li><li><a href="#using-translation-strings-as-keys">使用翻譯語句作為鍵</a></li></ul></li><li><a href="#retrieving-translation-strings">提取翻譯語句</a><ul><li><a href="#replacing-parameters-in-translation-strings">翻譯語句中的參數替換</a></li><li><a href="#pluralization">復數</a></li></ul></li><li><a href="#overriding-package-language-files">重寫擴展包的語言包</a></li></ul><a name="introduction"></a><h2><a href="#introduction">簡介</a></h2>Laravel 的本地化功能提供方便的方法來獲取多語言的字符串，讓你的網站可以簡單的支持多語言。語言包存放在 <code class=" language-php">resources/lang</code> 目錄下的文件里。在此目錄中應該有應用對應支持的語言并將其對應到每一個子目錄：<pre class=" language-php"><code class=" language-php">/resources /lang /en messages.php /es messages.php</code></pre>語言包簡單地返回鍵值和字符串數組，例如：<pre class=" language-php"><code class=" language-php"><?php return [ 'welcome' => 'Welcome to our application' ];</code></pre><h3>切換語言</h3>應用的默認語言保存在 <code class=" language-php">config/app.php</code> 配置文件中。當然，你可以根據需求自由的修改當前設置，可以使用 <code class=" language-php">App</code> facade 的 <code class=" language-php">setLocale</code> 方法動態地更改現有語言：<pre class=" language-php"><code class=" language-php">Route::get('welcome/{locale}', function ($locale) { App::setLocale($locale); // });</code></pre>你也可以設置「備用語言」，它將會在當現有語言沒有指定語句時被使用。就像默認語言那樣，備用語言也可以在 <code class=" language-php">config/app.php</code> 配置文件設置：<pre class=" language-php"><code class=" language-php">'fallback_locale' => 'en',</code></pre><h4>指定當前語言</h4>你可以使用 <code class=" language-php">App</code> facade 的 <code class=" language-php">getLocale</code> 及 <code class=" language-php">isLocale</code> 方法指定當前的語言環境或者檢驗當前語言是否是給定的值：<pre class=" language-php"><code class=" language-php">$locale = App::getLocale(); if (App::isLocale('en')) { // }</code></pre><a name="defining-translation-strings"></a><h2><a href="#defining-translation-strings">定義翻譯語句</a></h2><a name="using-short-keys"></a><h3>使用短鍵</h3>通常，語言包存放在 <code class=" language-php">resources/lang</code> 目錄下的文件里。在此目錄中應該有應用對應支持的語言并將其對應到每一個子目錄：<pre class=" language-php"><code class=" language-php">/resources /lang /en messages.php /es messages.php</code></pre>語言包簡單地返回鍵值和字符串數組，例如：<pre class=" language-php"><code class=" language-php"><?php // resources/lang/en/messages.php return [ 'welcome' => 'Welcome to our application' ];</code></pre><a name="using-translation-strings-as-keys"></a><h3>使用翻譯語句作為鍵</h3>對于有大量翻譯需求的應用，如果每一句翻譯語句都使用「短鍵」來定義，那么當你在視圖中嘗試去引用這些「短鍵」的時候，很容易變得混亂，分不清哪個對應哪個。因此，Laravel 也提供支持使用「默認語言」的翻譯語句作為鍵，來定義其他語言的翻譯語句。使用翻譯語句作為鍵的語言包需要在 <code class=" language-php">resources/lang</code> 目錄下保存為 JSON 文件。例如，如果你的應用中有西班牙語的語言包，你應該新建一個 <code class=" language-php">resources/lang/es.json</code> 文件：<pre class=" language-php"><code class=" language-php">{ "I love programming.": "Me encanta la programación." }</code></pre><a name="retrieving-translation-strings"></a><h2><a href="#retrieving-translation-strings">獲取翻譯語句</a></h2>你可以使用 <code class=" language-php">__</code> 輔助函數來獲取翻譯語句，<code class=" language-php">__</code> 方法接受文件名和鍵值作為其第一個參數。例如，讓我們提取 <code class=" language-php">resources/lang/messages.php</code> 中的 <code class=" language-php">welcome</code> ：<pre class=" language-php"><code class=" language-php">echo __('messages.welcome'); echo __('I love programming.');</code></pre>當然，如果你使用 <a href="/docs/5.4/blade">Blade 模板引擎</a>, 那么你可以在視圖文件中使用 <code class=" language-php">{{ }}</code> 語法或者使用 <code class=" language-php">@lang</code> 指令來輸出語句：<pre class=" language-php"><code class=" language-php">{{ __('messages.welcome') }} @lang('messages.welcome')</code></pre>如果指定的語句不存在，<code class=" language-php">__</code> 方法則會簡單的返回這個鍵名。所以，如果上述示例中的鍵不存在，那么 <code class=" language-php">__</code> 方法則會返回 <code class=" language-php">messages.welcome</code> 。<a name="replacing-parameters-in-translation-strings"></a><h3>翻譯語句中的參數替換</h3>如果需要，你也可以在翻譯語句中定義占位符。所有的占位符都使用的 <code class=" language-php">:</code> 開頭。例如，你可以自定義一則歡迎消息的占位符：<pre class=" language-php"><code class=" language-php">'welcome' => 'Welcome, :name',</code></pre>你可以在 <code class=" language-php">__</code> 方法中傳遞一個數組作為第二個參數，它會將數組的值替換到語言內容的占位符中：<pre class=" language-php"><code class=" language-php">echo __('messages.welcome', ['name' => 'dayle']);</code></pre>如果你的占位符中包含了首字母大寫或者全體大寫，翻譯過來的內容也會相應的做相應的處理：<pre class=" language-php"><code class=" language-php">'welcome' => 'Welcome, :NAME', // Welcome, DAYLE 'goodbye' => 'Goodbye, :Name', // Goodbye, Dayle</code></pre><a name="pluralization"></a><h3>復數</h3>復數是個復雜的問題，不同語言對于復數有不同的規則。使用管道符 <code class=" language-php">|</code> ，可以區分單復數字符串格式：<pre class=" language-php"><code class=" language-php">'apples' => 'There is one apple|There are many apples',</code></pre>你甚至可以創建使用更復雜的復數規則，例如根據數量的范圍不同來指定不同翻譯語句：<pre class=" language-php"><code class=" language-php">'apples' => '{0} There are none|[1,19] There are some|[20,*] There are many',</code></pre>當你定義完復數語句條件的時候，你可以使用 <code class=" language-php">trans_choice</code> 方法來設置「總數」以獲取符合對應條件的復數翻譯語句。例如，在這個例子中，設置「總數」為 10 ，符合數量范圍 1 至 19，所以會得到 <code class=" language-php">There are some</code> 這條復數語句：<pre class=" language-php"><code class=" language-php">echo trans_choice('messages.apples', 10);</code></pre><a name="overriding-package-language-files"></a><h2><a href="#overriding-package-language-files">重寫擴展包的語言包</a></h2>部分擴展包帶有自己的語言包，你可以通過在 <code class=" language-php">resources/lang/vendor/{package}/{locale}</code> 放置文件來重寫它們，而不是直接修改擴展包的核心文件。例如，你需要重寫 <code class=" language-php">skyrim/hearthfire</code> 擴展包的英文語言包 <code class=" language-php">messages.php</code> ，則需要把文件放置在 <code class=" language-php">resources/lang/vendor/hearthfire/en/messages.php</code> 。在這個文件中定義你想要重寫的翻譯語句，所有沒有重寫的語句將會加載擴展包的語言包中原來的語句。</article>