awes-io / localization-helper

方便使用 Laravel 本地化功能的包

v1.1.1 2019-10-10 16:10 UTC

This package is auto-updated.

Last update: 2024-09-11 03:25:20 UTC


README

Coverage report Build status Composer Ready Downloads Last version

方便使用 Laravel 本地化功能及快速生成语言文件的包。查看 contributing.md 了解待办事项列表。

安装

通过 Composer

$ composer require awes-io/localization-helper

Laravel 5.5 及以上版本,服务提供者和外观将会自动注册。对于旧版本,请按照以下步骤操作

config/app.php 中注册服务提供者

'providers' => [
// [...]
        AwesIO\LocalizationHelper\LocalizationHelperServiceProvider::class,
],

您也可以注册 LaravelLocalization 外观

'aliases' => [
// [...]
        'LocalizationHelper' => AwesIO\LocalizationHelper\Facades\LocalizationHelper::class,
],

配置

配置文件

要编辑默认配置,您可以执行以下操作

php artisan vendor:publish --provider="AwesIO\LocalizationHelper\LocalizationHelperServiceProvider"

之后,将会创建 config/localizationhelper.php 文件。

用法

包注册了全局辅助函数 _p($file_key, $default, $placeholders)

_p('auth.login', 'Login'); // "Login"

它将创建新的本地化文件 auth.php(如果不存在),并在 login 键下写入第二个参数作为语言字符串

return [
    "login" => "Login"
];

在第二次调用相同的文件/键 _p('auth.login') 时,将返回本地化字符串,文件保持不变。

也支持占位符

_p(
    'mail.invitation', 
    'You’re invited to join :company company workspace', 
    ['company' => 'Awesio']
);

如果返回了键,这意味着字符串已存在于本地化文件中,并且您正在尝试使用其值作为数组添加新的字符串。

// in localization file.php
return [
    "test" => "Test string"
];

_p('file.test.new', 'Test string'); // will return "file.test.new"

_p('file.test_2.new', 'Test string'); // will return "Test string"

// and modify localization file:
return [
    "test" => "Test string",
    "test_2" => [
        "new" => "Test string"
    ]
];

变更日志

请参阅 changelog 了解最近更改的信息。

测试

$ composer test

贡献

请参阅 contributing.md 了解详细信息及待办事项列表。

安全

如果您发现任何安全相关的问题,请发送电子邮件至 info@awescrm.de 而不是使用问题跟踪器。

鸣谢

许可协议

MIT