PhpStorm 2025.2 Help

翻译

根据正在开发的应用程序类型,您可能需要使用 Symfony 的 Translation 组件,将字符串和特定于区域的内容抽象到资源/文件中,以为特定区域提供正确的数据。

Symfony Support 插件通过为已知翻译和 domains 提供补全来协助 internationalization (通常缩写为 i18n)。 当使用不存在的翻译时,它会发出警告。 此外,它允许从控制器和模板中提取翻译。

请注意,要使这些功能正常工作,Symfony 应用程序的 Translator 服务需要被 enabled

翻译或域的代码补全

您可以通过 Translator 服务按 keydomain 查询特定消息。 在编辑器中,按 Ctrl+Space 调用以下任意项的代码补全:

  • 提供一个键,用于确定要获取的翻译。

    Symfony 翻译键补全
  • 提供一个域,用于确定从哪个资源文件获取翻译。

    Symfony 翻译域补全

键和域的补全在 PHP 代码和 Twig templates 中均可用。

翻译或域的代码导航

要导航到键或域的声明,请将光标放在其使用位置并按 Ctrl+B。 或者, Ctrl+Click 使用位置。

需要翻译的应用程序通常为每个区域提供多个资源。 在这种情况下,从弹出菜单中选择一个特定的声明进行导航。

导航到 Symfony 翻译域

缺失翻译或域检查

当您尝试使用不存在的翻译键或域时,PhpStorm 会显示来自 Missing Translation 检查的相应警告。 通过这种方式,您可以知道何时需要在资源文件之一中提供翻译。

Symfony 缺失翻译检查

对于翻译键,提供了快速修复功能,可以在资源文件中创建相应的翻译键。 要应用它,请将光标放在键上,按 Alt+Enter ,然后选择 Symfony:添加翻译

通过快速修复添加 Symfony 翻译

翻译键将被添加到资源文件中,您可以为其提供正确的值。

提取翻译

创建翻译需要编写使用 Translator 服务的代码,然后在资源文件中创建翻译。 为了加快此过程,Symfony Support 插件提供了 提取翻译 操作,允许您选择一个单词并从中创建翻译。

提取单词翻译

  1. 右键单击模板中的一个单词,然后从上下文菜单中选择 提取翻译

    提取 Symfony 翻译
  2. 在打开的 提取翻译键 对话框中,为翻译键提供一个有意义的名称。

    提取翻译对话框

    您还可以选择需要创建翻译的资源文件,并可选中复选框以在提取完成后打开资源文件。

  3. 点击 确定 以应用您的更改。 视图将更新为正确的语法,使用正确的翻译键和域。

    包含已提取翻译的模板

    翻译本身将被添加到选定的资源文件中。

最后修改日期: 2025年 9月 26日