README

本地化助手

用于方便使用 Laravel 的本地化功能以及快速生成语言文件的包。

安装

通过 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"
    ]
];

变更日志

有关最近更改的更多信息，请参阅变更日志。

测试

该包的覆盖率是。

您可以使用以下命令运行测试

composer test

贡献

有关详细信息和一个待办事项列表，请参阅contributing.md。

鸣谢

• Galymzhan Begimov
• 所有贡献者

许可证

MIT