Symfony翻译扩展包使用指南

---

项目介绍

PHP Translation Symfony Bundle 是一个专为 Symfony 框架设计的扩展包，旨在简化多语言环境下应用程序的翻译管理。它支持动态翻译编辑以及集成到 Symfony Profiler 中的翻译查看功能。通过这个扩展，开发者可以轻松地处理应用中的国际化（i18n）需求，提供灵活的配置选项来满足不同项目的需求。此库遵循 MIT 许可证。

项目快速启动

要迅速地将该扩展包集成至你的 Symfony 应用中，请按以下步骤操作：

安装依赖

打开终端，确保你已经安装了 Composer，然后在你的项目根目录下执行以下命令来添加依赖：

composer require php-translation/symfony-bundle

如果你的应用使用了 Symfony Flex，那么一切配置应该自动完成。否则，你需要手动进行以下步骤：

手动配置

注册 Bundle

在 config/bundles.php 文件中，加入如下代码来注册 bundle：

return [
    // ...
    \Translation\Bundle\TranslationBundle::class => ['all' => true],
];

配置翻译服务

接着，在相应的配置文件中（如 config/packages/php_translation.yaml），配置翻译基本设置：

translation:
    locales: ["en"]
    edit_in_place:
        enabled: false
    configs:
        app:
            dirs: ["%kernel.project_dir%/templates", "%kernel.project_dir%/src"]
            output_dir: "%kernel.project_dir%/translations"
            excluded_names: ["*TestCase.php", "*Test.php"]
            excluded_dirs: ["cache", "data", "logs"]

添加路由

最后，别忘了在路由配置中启用新的端点：

# config/routes/dev/php_translation.yaml
_translation_webui:
    resource: '@TranslationBundle/Resources/config/routing_webui.yaml'
    prefix: /admin

_translation_profiler:
    resource: '@TranslationBundle/Resources/config/routing_symfony_profiler.yaml'

# config/routes/php_translation.yaml
_translation_edit_in_place:
    resource: '@TranslationBundle/Resources/config/routing_edit_in_place.yaml'
    prefix: /admin

应用案例与最佳实践

为了充分利用 PHP Translation Symfony Bundle，你应该：

• 利用环境变量配置不同的翻译环境，例如开发环境中开启实时编辑特性。
• 组织翻译文件，保持逻辑清晰，通常每个业务模块对应一个或多个翻译文件。
• 利用 Symfony Profiler 监控翻译使用情况，以发现未被翻译的字符串。
• 定期备份翻译数据，特别是使用在线编辑功能时，以防意外丢失更改。

典型生态项目

在 Symfony 生态系统中，除了 php-translation/symfony-bundle 外，还有很多其他工具与之协同工作，比如：

• Doctrine翻译扩展：允许模型属性的多语言存储。
• EasyAdmin Bundle 结合使用，可以在后台管理系统中方便地管理翻译。
• Symfony Messenger 结合使用，实现翻译更新的异步处理。

不过，请注意这些示例是基于一般实践，并非直接由 php-translation/symfony-bundle 提供的功能，而是建议的生态系统整合方式。

---

以上就是关于 PHP Translation Symfony Bundle 的基本使用教程，从安装配置到实践策略，希望能帮助您高效地在您的 Symfony 应用中实现国际化功能。