本地化

• 介绍
• 语言文件
• 基本用法
• 复数
• 验证本地化
• 重写扩展包的语言文件

介绍

Laravel 的 Lang 类提供方便的方法来取得多种语言的字串，让您简单地在应用程序里支持多种语言。

语言文件

语言字串储存在 app/lang 文件夹的文件里。 在这个文件夹里应该要有子文件夹给每一个应用程序支持的语言。

/app
    /lang
        /en
            messages.php
        /es
            messages.php

语言文件例子

语言文件简单地返回键跟字串的数组。例如：

<?php

return array(
    'welcome' => 'Welcome to our application'
);

在执行时变换默认语言

应用程序的默认语言被储存在 app/config/app.php 配置文件。 您可以在任何时候用 App::setLocale 方法变换现行语言：

App::setLocale('es');

设定备用语言

您也可以设定 "备用语言"，它将会在当现行语言没有给定的语句时被使用。 就像默认语言，备用语言也可以在 app/config/app.php 配置文件设定：

'fallback_locale' => 'en',

基本用法

从语言文件取得句子

echo Lang::get('messages.welcome');

传递给 get 方法的字串的第一个部分是语言文件的名称，第二个部分是应该被取得的句子的名称。

备注: 如果句子不存在， get 方法将会返回键的名称。

您也可以使用 trans 辅助方法，它是 Lang::get 方法的别名。

echo trans('messages.welcome');

在句子中做替代

您也可以在语言文件中定义占位符：

'welcome' => 'Welcome, :name',

接着，传递替代用的第二个参数给 Lang::get 方法：

echo Lang::get('messages.welcome', array('name' => 'Dayle'));

判断语言文件是否有句子

if (Lang::has('messages.welcome'))
{
    //
}

复数

复数是个复杂的问题，不同语言对于复数有很多种复杂的规则。 您可以简单地在您的语言文件里管理它。 您可以用 "管道" 字串区分字串的单数和复数形态：

'apples' => 'There is one apple|There are many apples',

接着您可以用 Lang::choice 方法取得语句：

echo Lang::choice('messages.apples', 10);

您也可以提供一个地区参数来指定语言。 举个例，如果您想要使用俄语 (ru)：

echo Lang::choice('товар|товара|товаров', $count, array(), 'ru');

因为 Laravel 的翻译器继承了 Symfony 翻译组件，您也可以很容易地建立更明确的复数规则：

'apples' => '{0} There are none|[1,19] There are some|[20,Inf] There are many',

验证

要验证本地化的错误和信息，可以看一下 验证的文件.

重写扩展包的语言文件

许多扩展包附带它们自有的语句。 您可以通过放置文件在 app/lang/packages/{locale}/{package} 文件夹重写它们，而不是改变扩展包的核心文件来调整这些句子。 所以，举个例子，如果您需要重写 skyrim/hearthfire 扩展包在 messages.php 的英文语句 ，您可以放置语言文件在： app/lang/packages/en/hearthfire/messages.php。 您可以只定义您想要重写的语句在这个文件里，任何您没有重写的语句将会仍从扩展包的语言文件载入。