README

对于 Laravel 4，请使用0.1 分支！

这是一个用于管理 Laravel 翻译文件的包。它不会替换翻译系统，只是将 PHP 文件导入数据库，并通过 Web 界面使其可编辑。工作流程如下：

- Import translations: Read all translation files and save them in the database
- Find all translations in php/twig sources
- Optionally: Listen to missing translation with the custom Translator
- Translate all keys through the webinterface
- Export: Write all translations back to the translation files.

这样，翻译可以保存到 git 历史记录中，且不会在生产中引入任何开销。

安装

在您的 composer.json 中添加此包，并运行 composer update（或直接运行 composer require barryvdh/laravel-translation-manager）

"barryvdh/laravel-translation-manager": "0.2.x"

更新 composer 后，将 ServiceProvider 添加到 config/app.php 中的 providers 数组

'Barryvdh\TranslationManager\ManagerServiceProvider',

您需要为此包运行迁移。

$ php artisan vendor:publish --provider="Barryvdh\TranslationManager\ManagerServiceProvider" --tag=migrations
$ php artisan migrate

您需要发布此包的配置文件。这将添加 config/translation-manager.php 文件，您可以在其中配置此包。

$ php artisan vendor:publish --provider="Barryvdh\TranslationManager\ManagerServiceProvider" --tag=config

在 ServiceProvider 中添加了路由。您可以在配置中设置路由的组参数。您可以更改路由的前缀或过滤器/中间件。如果您想进行完全自定义，可以扩展 ServiceProvider 并覆盖 map() 函数。

此示例将使翻译管理器在 http://yourdomain.com/translations 可用

使用方法

Web 界面

当您通过按钮或命令导入翻译后，您可以在 Web 界面中查看它们（在您定义的控制器 URL 上）。您可以单击翻译，并弹出编辑字段。只需点击保存即可保存 :) 如果在另一个区域尚未创建翻译，您也可以直接编辑它以创建它。

您可以通过 Web 界面上的按钮导入/导出翻译。对于发布翻译，请确保您的应用程序可以写入语言目录。

您还可以使用以下命令。

导入命令

导入命令将在 app/lang 中搜索并加载所有字符串到数据库中，这样您可以轻松管理它们。

$ php artisan translations:import

注意：默认情况下，仅添加新的字符串。数据库中已有的翻译保持不变。如果您想用文件中的值替换所有值，请添加 --replace（或 -R）选项：php artisan translations:import --replace

在源代码中查找翻译

查找命令/按钮将在 app 目录中的所有 php/twig 文件中搜索，查看它们是否包含翻译函数，并尝试提取组/项名称。找到的键将被添加到数据库中，以便轻松翻译。这可以通过 Web 界面或 Artisan 命令完成。

$ php artisan translations:find

导出命令

导出命令将数据库内容写回到 app/lang php 文件中。这将覆盖现有翻译并删除所有注释，所以请在使用之前备份您的数据。提供组名以定义您想发布的组。

$ php artisan translations:export <group>

例如，当您有 2 个区域（en/nl）时，运行 php artisan translations:export reminders 将写入 app/lang/en/reminders.php 和 app/lang/nl/reminders.php

清理命令

清理命令将搜索所有 NULL 翻译并删除它们，以便您的界面更加整洁。注意：空翻译永远不会导出。

$ php artisan translations:clean

重置命令

重置命令只是简单地清除数据库中的所有翻译，因此您可以从头开始（通过新的导入）。在进行此操作之前，请确保需要的话导出您的工作。

$ php artisan translations:reset

检测缺失的翻译

大多数翻译可以通过使用查找命令（见上文）找到，但在您有动态键（变量/自动表单等）的情况下，倾听缺失的翻译可能很有帮助。为了检测缺失的翻译，我们可以将 Laravel TranslationServicepProvider 与自定义提供程序交换。在您的 config/app.php 中，注释掉原始的 TranslationServiceProvider，并添加此包中的一个。

//'Illuminate\Translation\TranslationServiceProvider',
'Barryvdh\TranslationManager\TranslationServiceProvider',

这将扩展翻译器，并在找不到密钥时创建新的数据库条目，这样您就必须访问使用它们的页面。这样它就会在Web界面中显示，可以编辑，然后可以导出。您不应该在生产环境中使用此功能，仅在需要翻译视图时使用，然后只需切换回来。

待办事项

此包仍处于alpha版本。待办事项列表中还有一些事情要做。

- Add locales/groups via webinterface
- Improve webinterface (more selection/filtering, behavior of popup after save etc)
- Seed existing languages (https://github.com/caouecs/Laravel4-lang)
- Suggestions are welcome :)