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

为了编辑默认模板，还需要发布视图。视图将放置在resources/views/vendor/translation-manager。

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

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

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

Laravel >= 5.2

默认情况下，配置文件仅包含auth中间件，但Laravel 5.2的最新更改使得只有在您的路由包含web中间件时，会话变量才可访问。为了使此包在Laravel 5.2上工作，您必须将路由/中间件设置从默认的

    'route' => [
        'prefix' => 'translations',
        'middleware' => 'auth',
    ],

更改为

    'route' => [
        'prefix' => 'translations',
        'middleware' => [
	        'web',
	        'auth',
		],
    ],

注意： 这仅适用于Laravel 5.2（及更高版本）

用法

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 TranslationServiceProvider替换为自定义提供者。在你的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 :)