README

为您的 Laravel 应用程序提供翻译管理。

关于 Laravel Translation

Laravel Translation 是一个 Laravel 扩展包，允许您在使用 Laravel 的本地化功能时，对翻译拥有完全控制。

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

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

以下是完整的功能列表

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

版本兼容性

安装

通过 Composer 安装包

composer require joedixon/laravel-translation

发布配置和资源

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

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

使用方法

配置

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

driver [file|database]

选择 file 或 database。文件翻译使用 Laravel 的原生文件基础翻译，并支持基于 array 和 json 的语言文件。

route_group_config.middleware [string|array]

将中间件应用到包附带的路由。例如，您可能想使用 auth 中间件以确保包的用户界面仅供已登录用户访问。

translation_methods [array]

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

scan_paths [array]

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

ui_url [string]

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

例如，将此值设置为 languages 将导致类似于 translations/{language}/translations 的 URL

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

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

emildayan / laravel-translation

维护者

详细信息