README

在纯Laravel或Lumen安装中，您可以使用语言文件来本地化应用程序。此包将启用将翻译存储在数据库中。您仍然可以使用您熟悉和喜爱的__辅助函数的所有功能。

__('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的默认__函数来获取翻译

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

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

__('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

贡献

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

安全

如果您发现与安全相关的错误，请通过security@spatie.be发送邮件，而不是使用问题追踪器。

鸣谢

• Freek Van der Herten
• 所有贡献者

许可证

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