本地化

• 介绍
• 检索语言行
  • 替换语言行中的参数
  • 复数化
• 覆盖包的语言文件

介绍

Laravel 的本地化功能提供了一种方便的方法来检索各种语言的字符串，使您可以轻松支持应用程序中的多种语言。语言字符串存储在 resources/lang 目录中的文件中。在此目录中，应该为应用程序支持的每种语言创建一个子目录：

/resources
    /lang
        /en
            messages.php
        /es
            messages.php

所有语言文件都简单地返回一个键值对的数组。例如：

<?php

return [
    'welcome' => '欢迎使用我们的应用程序'
];

配置语言环境

应用程序的默认语言存储在 config/app.php 配置文件中。当然，您可以根据应用程序的需要修改此值。您还可以使用 App facade 上的 setLocale 方法在运行时更改活动语言：

Route::get('welcome/{locale}', function ($locale) {
    App::setLocale($locale);

    //
});

您可以配置一个“后备语言”，当活动语言不包含给定的语言行时将使用该语言。与默认语言一样，后备语言也在 config/app.php 配置文件中配置：

'fallback_locale' => 'en',

确定当前语言环境

您可以使用 App facade 上的 getLocale 和 isLocale 方法来确定当前语言环境或检查语言环境是否为给定值：

$locale = App::getLocale();

if (App::isLocale('en')) {
    //
}

检索语言行

您可以使用 trans 辅助函数从语言文件中检索行。trans 方法接受文件和语言行的键作为其第一个参数。例如，让我们从 resources/lang/messages.php 语言文件中检索 welcome 语言行：

echo trans('messages.welcome');

当然，如果您使用 Blade 模板引擎，您可以使用 {{ }} 语法来输出语言行或使用 @lang 指令：

{{ trans('messages.welcome') }}

@lang('messages.welcome')

如果指定的语言行不存在，trans 函数将简单地返回语言行键。因此，使用上面的例子，如果语言行不存在，trans 函数将返回 messages.welcome。

替换语言行中的参数

如果您愿意，可以在语言行中定义占位符。所有占位符都以 : 为前缀。例如，您可以定义一个带有占位符名称的欢迎消息：

'welcome' => '欢迎, :name',

要在检索语言行时替换占位符，请将替换数组作为第二个参数传递给 trans 函数：

echo trans('messages.welcome', ['name' => 'dayle']);

如果您的占位符包含所有大写字母，或仅首字母大写，翻译后的值将相应地大写：

'welcome' => '欢迎, :NAME', // 欢迎, DAYLE
'goodbye' => '再见, :Name', // 再见, Dayle

复数化

复数化是一个复杂的问题，因为不同的语言有各种复杂的复数化规则。通过使用“管道”字符，您可以区分字符串的单数和复数形式：

'apples' => '有一个苹果|有很多苹果',

在定义了具有复数化选项的语言行后，您可以使用 trans_choice 函数根据给定的“计数”来检索该行。在此示例中，由于计数大于一，因此返回语言行的复数形式：

echo trans_choice('messages.apples', 10);

由于 Laravel 翻译器由 Symfony Translation 组件提供支持，您可以创建更复杂的复数化规则，为多个数字范围指定语言行：

'apples' => '{0} 没有苹果|[1,19] 有一些苹果|[20,Inf] 有很多苹果',

覆盖包的语言文件

某些包可能附带自己的语言文件。您可以通过在 resources/lang/vendor/{package}/{locale} 目录中放置文件来覆盖这些行，而不是更改包的核心文件。

因此，例如，如果您需要覆盖名为 skyrim/hearthfire 的包的 messages.php 中的英文语言行，您应该在以下位置放置一个语言文件：resources/lang/vendor/hearthfire/en/messages.php。在此文件中，您只需定义要覆盖的语言行。您不覆盖的任何语言行仍将从包的原始语言文件中加载。