awes-io / localization-helper
方便使用 Laravel 本地化功能的包
v1.1.1
2019-10-10 16:10 UTC
Requires
- illuminate/support: ~5|~6
Requires (Dev)
- mikey179/vfsstream: ^1.6
- mockery/mockery: ^1.1
- orchestra/testbench: ~3.0
- phpunit/phpunit: ~7.0
- sempro/phpunit-pretty-print: ^1.0
README
方便使用 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 而不是使用问题跟踪器。