awema-pl/module-localization-helper

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

v1.0.6 2021-12-14 11:15 UTC

This package is auto-updated.

Last update: 2024-09-14 16:55:43 UTC


README

Coverage report Build status Composer Ready Downloads Last version

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

安装

通过Composer

$ composer require awema-pl/module-localization-helper

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

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

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

您还可以注册 LaravelLocalization 外观

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

配置

配置文件

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

php artisan vendor:publish --provider="AwemaPL\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' => 'AwemaPL']
);

如果返回键,则表示字符串已存在于本地化文件中,您正在尝试使用其值作为数组添加新的一个。

// 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@awema.pl报告,而不是使用问题跟踪器。

鸣谢

许可证

MIT