iyogesharma/translation-laravel

管理所有Laravel翻译的工具

v2.0 2024-05-15 10:31 UTC

This package is auto-updated.

Last update: 2024-09-15 11:11:19 UTC


README

Laravel Translation

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

Laravel Translation UI

GitHub GitHub

关于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]

选择filedatabase。文件翻译使用Laravel的本地文件翻译,并支持基于arrayjson的语言文件。

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() 等)都将从数据库中加载相关字符串,而不是文件,而无需更改您应用程序中的任何代码。这是一个等价交换。

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

将驱动程序从文件(默认)更改为数据库

  1. ./config/translation.php 中更新驱动程序以使用数据库。
'driver' => 'database'
  1. 运行迁移以添加翻译和语言表。
php artisan migrate
  1. 运行以下命令,并按照提示同步驱动程序之间的翻译。
php artisan translation:sync-translations
  1. 将会有几个问题需要回答。请参阅下面的截图

用户界面

导航到 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

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