[!NOTE]
默认情况下，Laravel 应用程序骨架不包含lang目录。如果您想自定义 Laravel 的语言文件，可以通过lang:publishArtisan 命令发布它们。
Laravel 的本地化功能提供了一种便捷的方式，用于检索各种语言的字符串，使您能够轻松地在应用程序中支持多种语言。
Laravel 提供了两种管理翻译字符串的方式。首先，语言字符串可以存储在应用程序的 lang 目录中的文件中。在该目录中，可以为应用程序支持的每种语言设置子目录。这是 Laravel 用于管理内置 Laravel 功能（例如验证错误消息）翻译字符串的方法：
/lang
/en
messages.php
/es
messages.php或者，翻译字符串可以定义在 lang 目录下的 JSON 文件中。采用这种方法时，您的应用程序支持的每种语言都将在此目录下拥有一个对应的 JSON 文件。对于具有大量可翻译字符串的应用程序，建议采用此方法：
/lang
en.json
es.json我们将在本文档中讨论管理翻译字符串的每种方法。
默认情况下，Laravel 应用程序骨架不包含 lang 目录。如果您想自定义 Laravel 的语言文件或创建您自己的语言文件，您应该通过 lang:publish Artisan 命令搭建 lang 目录。 lang:publish 命令将在您的应用程序中创建 lang 目录，并发布 Laravel 所使用的默认语言文件集：
php artisan lang:publish你的应用程序的默认语言存储在 config/app.php 配置文件的 locale 配置选项，该选项通常使用 APP_LOCALE 环境变量设置。你可以随意修改此值以适应你的应用程序的需求。
您也可以配置一个“回退语言”，当默认语言不包含给定的翻译字符串时，将使用该语言。类似于默认语言，回退语言也在 config/app.php 配置文件中配置，其值通常使用 APP_FALLBACK_LOCALE 环境变量设置。
你可以使用 App 门面提供的 setLocale 方法，在运行时为单个 HTTP 请求修改默认语言：
use Illuminate\Support\Facades\App;
Route::get('/greeting/{locale}', function (string $locale) {
if (! in_array($locale, ['en', 'es', 'fr'])) {
abort(400);
}
App::setLocale($locale);
// ...
});您可以使用 App facade 上的 currentLocale 和 isLocale 方法来确定当前语言环境或检查语言环境是否为给定值：
use Illuminate\Support\Facades\App;
$locale = App::currentLocale();
if (App::isLocale('en')) {
// ...
}You may instruct Laravel's "pluralizer", which is used by Eloquent and other portions of the framework to convert singular strings to plural strings, to use a language other than English. This may be accomplished by invoking the useLanguage method within the boot method of one of your application's service providers. The pluralizer's currently supported languages are: french, norwegian-bokmal, portuguese, spanish, and turkish:
use Illuminate\Support\Pluralizer;
/**
* Bootstrap any application services.
*/
public function boot(): void
{
Pluralizer::useLanguage('spanish');
// ...
}[!WARNING]
如果你自定义复数器的语言，你应该明确定义你的 Eloquent 模型的表名。
通常，翻译字符串存储在 lang 目录中的文件中。在此目录中，应该有一个子目录，针对你的应用程序支持的每种语言。这是 Laravel 用于管理内置 Laravel 功能（例如验证错误消息）的翻译字符串的方法：
/lang
/en
messages.php
/es
messages.php所有语言文件都返回一个键控字符串数组。例如：
<?php
// lang/en/messages.php
return [
'welcome' => 'Welcome to our application!',
];[!警告]
对于按地区划分的语言，您应该根据 ISO 15897 命名语言目录。例如，"en_GB" 应用于英式英语，而不是 "en-gb"。
对于具有大量可翻译字符串的应用程序，使用“短键”定义每个字符串在视图中引用这些键时可能会变得令人困惑，并且不断为应用程序支持的每个翻译字符串发明键也很麻烦。
因此，Laravel 还提供支持，可以使用字符串的“默认”翻译作为键来定义翻译字符串。使用翻译字符串作为键的语言文件以 JSON 文件形式存储在 lang 目录中。例如，如果您的应用程序有西班牙语翻译，您应该创建一个 lang/es.json 文件：
{
"I love programming.": "Me encanta programar."
}你不应该定义与其他翻译文件名冲突的翻译字符串键。例如，在 nl/action.php 文件存在但 nl.json 文件不存在的情况下，为 "NL" 语言环境翻译 __('Action') 将导致翻译器返回 nl/action.php 的全部内容。
您可以使用 __ 辅助函数从您的语言文件检索翻译字符串。如果您正在使用“短键”来定义您的翻译字符串，您应该使用“点”语法将包含该键的文件和键本身传递给 __ 函数。例如，让我们从 lang/en/messages.php 语言文件中检索 welcome 翻译字符串：
echo __('messages.welcome');如果指定的翻译字符串不存在，__ 函数将返回翻译字符串键。因此，以上述示例为例，如果翻译字符串不存在，__ 函数将返回 messages.welcome。
如果您正在使用您的默认翻译字符串作为翻译键，您应该将字符串的默认翻译传递给 __ 函数；
echo __('I love programming.');再次，如果翻译字符串不存在，__ 函数将返回它被传入的翻译字符串键。
如果您正在使用Blade 模板引擎， 您可以使用 {{ }} echo 语法来显示翻译字符串：
{{ __('messages.welcome') }}如果您愿意，您可以在翻译字符串中定义占位符。所有占位符都以 : 开头。例如，您可以定义一个带占位符名称的欢迎消息：
'welcome' => 'Welcome, :name',要在检索翻译字符串时替换占位符，您可以将替换数组作为第二个参数传递给 __ 函数：
echo __('messages.welcome', ['name' => 'dayle']);如果您的占位符包含所有大写字母，或者只将其首字母大写，翻译值将相应地大写：
'welcome' => 'Welcome, :NAME', // Welcome, DAYLE
'goodbye' => 'Goodbye, :Name', // Goodbye, Dayle如果您尝试提供一个对象作为翻译占位符，该对象的__toString方法将被调用. 该__toString方法是PHP内置的"魔术方法". 然而，有时您可能无法控制给定类的__toString方法，例如当您正在与之交互的类属于第三方库时.
在这些情况下，Laravel 允许你为该特定类型的对象注册一个自定义的格式化处理器。为了实现这一点，你应该调用翻译器的 stringable 方法。 stringable 方法接受一个闭包，该闭包应类型提示它负责格式化的对象类型。通常， stringable 方法应在你应用的 AppServiceProvider 类的 boot 方法中被调用：
use Illuminate\Support\Facades\Lang;
use Money\Money;
/**
* Bootstrap any application services.
*/
public function boot(): void
{
Lang::stringable(function (Money $money) {
return $money->formatTo('en_GB');
});
}复数化是一个复杂的问题，因为不同的语言有各种复杂的复数规则；然而，Laravel 可以帮助你根据你定义的复数规则来翻译不同的字符串。使用 | 字符，你可以区分字符串的单数和复数形式：
'apples' => 'There is one apple|There are many apples',当然，在使用将翻译字符串用作键时也支持复数形式：
{
"There is one apple|There are many apples": "Hay una manzana|Hay muchas manzanas"
}您甚至可以创建更复杂的复数规则，用于指定适用于多个值范围的翻译字符串：
'apples' => '{0} There are none|[1,19] There are some|[20,*] There are many',定义了具有复数形式选项的翻译字符串后，您可以使用 trans_choice 函数来检索给定“count”的行。在此示例中，由于计数大于一，将返回翻译字符串的复数形式：
echo trans_choice('messages.apples', 10);你也可以在复数化字符串中定义占位符属性。这些占位符可以通过向 trans_choice 函数传递一个数组作为第三个参数来替换：
'minutes_ago' => '{1} :value minute ago|[2,*] :value minutes ago',
echo trans_choice('time.minutes_ago', 5, ['value' => 5]);如果您想显示传递给 trans_choice 函数的整数值, 您可以使用内置的 :count 占位符:
'apples' => '{0} There are none|{1} There is one|[2,*] There are :count',一些包可能附带其语言文件。与其修改包的核心文件来调整这些行，您可以通过将文件放置在 lang/vendor/{package}/{locale} 目录中来覆盖它们。
因此，例如，如果您需要覆盖名为 skyrim/hearthfire 的软件包中 messages.php 内的英文翻译字符串，您应该将语言文件放置在：lang/vendor/hearthfire/en/messages.php。在此文件中，您应该只定义您希望覆盖的翻译字符串。任何您未覆盖的翻译字符串仍将从软件包的原始语言文件中加载。