README

在纯Laravel或Lumen安装中，您可以使用 语言文件 来本地化您的应用程序。此包将使翻译存储在数据库中。您仍然可以使用您所熟悉的 trans 函数。

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

您甚至可以混合使用语言文件和数据库。如果翻译在文件和数据库中都存在，则返回数据库版本。

想使用不同的翻译来源？没问题！该包易于扩展。

Spatie 是一家位于比利时的安特卫普的网络设计公司。您可以在我们的网站上找到所有开源项目的概述 在这里。

支持我们

我们投入了大量资源来创建 一流的开放源代码包。您可以通过 购买我们的付费产品之一 来支持我们。

我们非常感谢您从您的家乡寄给我们明信片，说明您正在使用我们的哪个包。您可以在我们的 联系方式 页面上找到我们的地址。我们将发布所有收到的明信片在我们的 虚拟明信片墙上。

安装

您可以通过 composer 安装此包

composer require spatie/laravel-translation-loader

在 config/app.php（Laravel）或 bootstrap/app.php（Lumen）中，您应将 Laravel 的翻译服务提供程序替换为该包中包含的提供程序

Illuminate\Translation\TranslationServiceProvider::class,

Spatie\TranslationLoader\TranslationServiceProvider::class,

您必须发布和运行迁移来创建 language_lines 表

php artisan vendor:publish --provider="Spatie\TranslationLoader\TranslationServiceProvider" --tag="migrations"
php artisan migrate

可选地，您可以使用此命令发布配置文件。

php artisan vendor:publish --provider="Spatie\TranslationLoader\TranslationServiceProvider" --tag="config"

这是已发布配置文件的内容

return [

    /*
     * Language lines will be fetched by these loaders. You can put any class here that implements
     * the Spatie\TranslationLoader\TranslationLoaders\TranslationLoader-interface.
     */
    'translation_loaders' => [
        Spatie\TranslationLoader\TranslationLoaders\Db::class,
    ],

    /*
     * This is the model used by the Db Translation loader. You can put any model here
     * that extends Spatie\TranslationLoader\LanguageLine.
     */
    'model' => Spatie\TranslationLoader\LanguageLine::class,

    /*
     * This is the translation manager which overrides the default Laravel `translation.loader`
     */
    'translation_manager' => Spatie\TranslationLoader\TranslationLoaderManager::class,

];

注意：在 Lumen 中，自动发布资产不起作用。相反，您必须从存储库复制文件。

使用方法

您可以通过创建并保存 Spatie\TranslationLoader\LanguageLine 模型的实例在数据库中创建翻译

use Spatie\TranslationLoader\LanguageLine;

LanguageLine::create([
   'group' => 'validation',
   'key' => 'required',
   'text' => ['en' => 'This is a required field', 'nl' => 'Dit is een verplicht veld'],
]);

您可以使用 Laravel 的默认 trans 函数 来获取翻译

trans('validation.required'); // returns 'This is a required field'

app()->setLocale('nl');

trans('validation.required'); // returns 'Dit is een verplicht veld'

您仍然可以使用默认的语言文件。如果请求的翻译在数据库和语言文件中都有，则返回数据库版本。

如果您需要存储/覆盖 json 翻译行，只需创建具有 group => '*' 的常规 LanguageLine 即可。

创建您自己的翻译提供者

此包附带了一个可以从数据库中获取翻译的翻译提供程序。如果您将翻译存储在 yaml 文件、csv 文件中等，您可以通过创建自己的翻译提供程序轻松扩展此包。

翻译提供程序可以是任何实现 Spatie\TranslationLoader\TranslationLoaders\TranslationLoader 接口的类。它仅包含一个方法

namespace Spatie\TranslationLoader\TranslationLoaders;

interface TranslationLoader
{
    /*
     * Returns all translations for the given locale and group.
     */
    public function loadTranslations(string $locale, string $group): array;
}

翻译提供程序可以在配置文件的 translation_loaders 键中注册。

变更日志

请参阅变更日志获取最近更改的更多信息。

测试

composer test

贡献

请参阅贡献指南获取详细信息。

安全

如果您发现任何安全相关的问题，请通过电子邮件发送至freek@spatie.be，而不是使用问题跟踪器。

致谢

• Freek Van der Herten
• 所有贡献者

许可证

MIT许可证（MIT）。请参阅许可证文件获取更多信息。