younes-el-barnoussi/laravel-translation

用于管理所有 Laravel 翻译的工具


README

joedixon/laravel-translation 继承,该分支已废弃

如何使用这个分支替代原始版本?

composer.json 中添加

...
"repositories": [
  {
    "type": "vcs",
    "url": "git@github.com:eduPHP/laravel-translation.git"
  }
],
...

然后,更改 joedixon/laravel-translation 依赖的版本标签

...
"require": {
 ...
    "joedixon/laravel-translation": "^1.2.0",
 ...
}
...

Laravel Translation

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

Laravel Translation UI

Travis (.org) branch Scrutinizer Scrutinizer Coverage GitHub

关于 Laravel 翻译

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

该包允许您使用基于文件的本地化翻译,同时也提供了一种数据库驱动,这对于多服务器设置非常有用。

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

以下是完整的功能列表

  • 文件和数据库驱动
  • 数据库翻译加载器(在 Laravel 的翻译检索方法和数据库驱动时自动从数据库中加载翻译)
  • 用户界面,用于添加新语言和添加/更新翻译
  • Artisan 命令来管理您的翻译
  • 扫描您的应用程序以查找缺失的翻译

安装

通过 Composer 安装此包

composer require joedixon/laravel-translation

发布配置和资源

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

服务提供程序将自动通过 package discovery 加载。

使用方法

配置

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

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

用户界面

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

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