本地化

• 介绍
• 基本用法
  • 复数化
• 覆盖供应商语言文件

介绍

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 上的 isLocale 方法来检查当前是否正在使用给定的语言环境：

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

要检索当前应用程序的语言环境，请调用 App facade 上的 getLocale 方法：

return App::getLocale();

基本用法

您可以使用 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。在此文件中，您只需定义要覆盖的语言行。您不覆盖的任何语言行仍将从包的原始语言文件中加载。