README

此包是Joedixon/Laravel-Translation Package的api支持分支

原始Readme.md

Laravel应用程序的翻译管理。

关于Laravel Translation

Laravel Translation是一个为Laravel设计的包，它允许您在使用Laravel的本地化功能时完全控制您的翻译。

该包允许您使用基于文件的本地化或数据库驱动程序来管理翻译，后者在多服务器配置中非常有用。

它提供了一个用户界面，允许您更新现有翻译并添加新翻译到您的应用程序中。

以下是完整功能列表

文件和数据库驱动程序
数据库翻译加载器（当使用Laravel的翻译检索方法和数据库驱动程序时，自动从数据库加载翻译）
用户界面以添加新语言和添加/更新翻译
Artisan命令以管理翻译
扫描应用程序以查找缺少的翻译

版本兼容性

安装

通过Composer安装包

composer require brnysn/laravel-translation

发布配置和资源

php artisan vendor:publish --provider="Brnysn\Translation\TranslationServiceProvider"

服务提供程序将通过包发现自动加载。

使用方法

配置

该包附带一个名为translation.php的配置文件，在安装过程中发布到config目录。以下是设置概要。

driver [file|database]

选择file或database。文件翻译利用Laravel的本地文件翻译，并支持基于array和json的本地文件。

route_group_config.middleware [string|array]

将中间件应用于包附带的路由。例如，您可能希望使用auth中间件以确保包用户界面仅对登录用户可用。

api_route_group_config.middleware [string|array]

将中间件应用于包附带的API路由。例如，您可能希望使用auth:api中间件以确保包用户界面仅对登录用户可用。

translation_methods [array]

选择在搜索缺少的翻译键时使用哪个Laravel翻译方法。

scan_paths [array]

选择在搜索缺少的翻译时使用哪个路径。将搜索范围缩小到特定目录将提高扫描缺少翻译时的性能。

ui_url [string]

选择包用户界面可以访问的根URL。所有路由都将以前缀值开头。

例如，将此值设置为languages将导致URL如下：languages/{language}/translations

api_url [string]

选择用户可以从API访问的根URL。所有路由都将以前缀值开头。

例如，将此值设置为api/languages将导致URL如下：api/languages/{language}/translations

database.languages_table

选择使用数据库驱动程序时使用的语言表名称。

database.translations_table

选择使用数据库驱动程序时使用的翻译表名称。

驱动程序

文件

利用Laravel原生PHP数组和基于JSON的语言文件，并提供了用户界面来管理包含的翻译。您可以通过用户界面或内置的Artisan命令添加和更新语言和翻译。

数据库

数据库驱动程序继承了Laravel基于文件的语言文件的所有功能，但将存储移至数据库，利用为您的Laravel应用程序配置的连接。

它还替换了容器中的翻译加载器，因此Laravel的所有翻译检索方法（__()、trans()、@lang()等）将直接从数据库而不是文件中加载相关字符串，而无需更改应用程序中的任何代码。这是一种直接替换。

要使用数据库驱动程序，请确保更新配置文件中的数据库表名并运行迁移。

从文件（默认）切换到数据库驱动程序

在./config/translation.php中更新驱动程序以使用数据库。

'driver' => 'database'

运行迁移以添加翻译和语言表。

php artisan migrate

运行以下命令，并按照提示同步驱动程序之间的翻译。

php artisan translation:sync-translations

将提示几个问题，需要回答。请参阅下面的截图

用户界面

导航到http://your-project.test/languages（将languages更新为与translation.ui_url配置设置匹配）并使用界面来管理您的翻译。

首先，点击您想要编辑的语言。在随后的页面上，找到您想要编辑的翻译，并点击铅笔图标或文本进行编辑。一旦您从输入框移开焦点，您的翻译就会被保存，并用绿色勾选图标表示。

Artisan命令

该软件包包含一系列Artisan命令，可帮助管理翻译。

translation:add-language

向应用程序添加新语言。

translation:add-translation-key

为应用程序添加新语言键。

translation:list-languages

列出应用程序中所有可用的语言。

translation:list-missing-translation-keys

列出应用程序中所有没有相应翻译的翻译键。

translation:sync-translations

在驱动程序之间同步翻译。如果您有一个正在使用原生基于文件的语言文件的应用程序，并希望迁移到数据库驱动程序，这个命令非常有用。运行此命令将从语言文件中获取所有翻译并将其插入到数据库中。

translation:sync-missing-translation-keys

此命令将扫描您的项目（使用配置文件中提供的路径）并创建所有缺失的翻译键。这可以对所有语言或单个语言运行。

brnysn / laravel-translation

维护者

详细信息