solitweb / laravel-langman
轻松管理语言文件。
Requires
- php: ^8.0
- illuminate/console: ^8.45
- illuminate/filesystem: ^8.45
- illuminate/support: ^8.45
Requires (Dev)
- mockery/mockery: ^1.4
- orchestra/database: ^6.0
- orchestra/testbench: ^6.18
- phpunit/phpunit: ^9.5
README
Langman 是一个位于 artisan 控制台的语言文件管理器,它帮助您轻松搜索、更新、添加和删除翻译行。不再需要为多语言界面头疼。
安装
首先,通过 Composer 安装此软件包。在您的终端运行以下命令
$ composer require themsaid/laravel-langman
完成后,在 config/app.php 的 providers 数组中添加以下行
Themsaid\Langman\LangmanServiceProvider::class
此软件包具有单个配置选项,指向 resources/lang 目录,如果您需要更改路径,请发布配置文件
php artisan vendor:publish --provider="Themsaid\Langman\LangmanServiceProvider"
用法
显示翻译文件的行
php artisan langman:show users
您将获得
+---------+---------------+-------------+
| key | en | nl |
+---------+---------------+-------------+
| name | name | naam |
| job | job | baan |
+---------+---------------+-------------+
php artisan langman:show users.name
仅返回所有语言中 name 键的翻译。
php artisan langman:show users.name.first
返回嵌套键的翻译。
php artisan langman:show package::users.name
返回供应商包语言文件的翻译。
php artisan langman:show users --lang=en,it
仅返回 "en" 和 "it" 语言的翻译。
php artisan langman:show users.nam -c
仅返回与给定键通过接近匹配匹配的翻译行,因此搜索 nam 将为键如 (name,username,branch_name_required,等...) 带来值。
在此命令返回的表中,如果翻译丢失,它将以红色标出。
查找翻译行
php artisan langman:find 'log in first'
您将获得一个表格,其中任何值都与给定短语通过接近匹配匹配。
在视图文件中搜索缺失的翻译
php artisan langman:sync
此命令将在 resources/views 和 app 中的所有文件中查找所有未在您的翻译文件中覆盖的翻译键,然后将其附加到值为空字符串的文件中。
填充缺失的翻译
php artisan langman:missing
它将收集所有在任一语言中缺失或值为空字符串的键,提示您为每个键提供翻译,并最终将提供的值保存到文件中。
翻译键
php artisan langman:trans users.name
php artisan langman:trans users.name.first
php artisan langman:trans users.name --lang=en
php artisan langman:trans package::users.name
使用此命令,您可以设置给定组的语言键(纯文本或嵌套),您还可以指定您希望设置的哪种语言,其他语言保持不变。
如果不存在,此命令将添加新键,如果已存在,则更新键。
删除键
php artisan langman:remove users.name
php artisan langman:remove package::users.name
它将从所有语言文件中删除该键。
重命名键
php artisan langman:rename users.name full_name
这将把 users.name 重命名为 users.full_name,控制台将输出曾经使用过该键的文件列表。
注意
langman:sync、langman:missing、langman:trans 和 langman:remove 将通过完全写入来更新您的语言文件,这意味着任何注释或特殊样式都将被删除,所以我建议您备份您的文件。
Web 界面
如果您想有一个用于管理语言文件的 Web 界面,我推荐由 Barry vd. Heuvel 开发的 Laravel 5 Translation Manager。