翻译

编辑本页

警告:您正在浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 4.3,现已不再维护。

本页的更新版本用于Sy欧宝娱乐app下载地址mfony 6.2(当前稳定版本)。

翻译

术语“国际化”(通常缩写为i18n)指的是将字符串和其他特定于语言环境的部分从应用程序抽象到一个层,在这个层中,它们可以根据用户的语言环境(即语言和国家)进行翻译和转换。对于文本,这意味着用一个能够将文本(或“消息”)翻译成用户语言的函数来包装每一个:

1 2 3 4 5 6
//文本将始终打印出英文回声“Hello World”//文本可以翻译成最终用户的语言或//默认为英文回声翻译->反式(“Hello World”);

请注意

这个词语言环境大致指用户的语言和国家。它可以是应用程序用来管理翻译和其他格式差异(例如货币格式)的任何字符串。的ISO 639 - 1语言代码,一个下划线(_),然后ISO 3166-1 alpha-2国家代码(如。fr_FR法语/法国)。

翻译过程有几个步骤:

  1. 启用和配置欧宝娱乐app下载地址Symfony的翻译服务;
  2. 抽象字符串(例如:的调用来封装它们翻译(“翻译”);
  3. 创建翻译资源/文件对于翻译应用程序中每条消息的受支持的语言环境;
  4. 确定,设置和管理用户的语言环境对于请求和可选的在用户的整个会话上

安装

首先,在使用转换器之前,运行这个命令来安装它:

1
作曲家需要交响乐/翻译欧宝娱乐app下载地址

配置

上面的命令创建了一个初始配置文件,您可以在其中定义应用程序的默认语言环境和回退地区如果Symfony找不到一些翻译,就会使用欧宝娱乐app下载地址:

  • YAML
  • XML
  • PHP
1 2 3 4 5 6
#配置/包/ translation.yaml框架:default_locale:“en”翻译:回退:(“en”)#……

翻译中使用的语言环境是存储在请求中的语言环境。这通常是通过_locale属性(请参阅如何使用用户的语言环境).

基本的翻译

文本的翻译是通过翻译服务(翻译).翻译一个文本块(称为文本块)消息),使用反式()方法。假设,例如,你正在翻译一个来自控制器内部的简单消息:

1 2 3 4 5 6 7 8 9
/ /……使用欧宝娱乐app下载地址合同翻译TranslatorInterface公共函数指数(TranslatorInterface翻译翻译翻译->反式(“欧宝娱乐app下载地址Symfony很棒”);/ /……

当执行这段代码时,Symfony将尝试基于欧宝娱乐app下载地址语言环境用户的。为此,您需要告诉Symfony如何通过“翻译资源”翻译消息,“翻译资源欧宝娱乐app下载地址”通常是一个包含给定语言环境的翻译集合的文件。这个翻译“字典”可以用几种不同的格式创建:

  • YAML
  • XML
  • PHP
1 2
#翻译/ messages.fr.yaml欧宝娱乐app下载地址Symfony很棒:欧宝娱乐app下载地址

有关这些文件应位于何处的信息,请参见翻译

现在,如果用户所在地区的语言是法语(例如;fr_FRfr_BE),讯息会被翻译成我Symfon欧宝娱乐app下载地址y.你也可以在你的模板

使用真实消息或关键字消息

这个例子说明了在创建要翻译的消息时的两种不同的哲学:

1 2 3
翻译->反式(“欧宝娱乐app下载地址Symfony很棒”);翻译->反式(“欧宝娱乐app下载地址symfony.great”);

在第一种方法中,消息用默认地区的语言编写(在本例中为英语)。然后在创建翻译时将该消息用作“id”。

在第二种方法中,消息实际上是传达消息思想的“关键字”。然后将关键字消息用作任何翻译的“id”。在这种情况下,必须对默认区域进行翻译(即翻译欧宝娱乐app下载地址symfony.great欧宝娱乐app下载地址Symfony很棒).

第二种方法很方便,因为如果您决定消息在默认语言环境中实际上应该读作“Symfony is really great”,则不需要在每个翻译文件中更改消息键。欧宝娱乐app下载地址

选择使用哪种方法完全取决于您,但“关键字”格式通常推荐用于多语言应用程序,而对于包含翻译资源的共享包,我们推荐使用真实消息,因此您的应用程序可以选择禁用翻译层,并且您将看到可读的消息。

此外,php而且yaml文件格式支持嵌套id,以避免重复使用关键字而不是实际文本的id:

  • YAML
  • PHP
12 3 4 5 6 7 8 9 10 11 12
欧宝娱乐app下载地址symfony:是:# id是sym欧宝娱乐app下载地址fony.is.great大:欧宝娱乐app下载地址伟大的# id是sym欧宝娱乐app下载地址fony.is.amazing惊人的:欧宝娱乐app下载地址令人惊异的有:# id是sym欧宝娱乐app下载地址fy .has.bundles包:欧宝娱乐app下载地址用户:# id是user.login登录:登录

翻译过程

属性时,Symfony使用以下过程来实际翻译消息欧宝娱乐app下载地址反式()方法:

  1. 语言环境当前用户的,哪个存储在请求上;
  • 类定义的翻译资源中加载翻译消息的目录(例如大的集合)语言环境(如。fr_FR).来自回退场所如果它们还不存在,也会加载并添加到目录中。最终的结果是一个巨大的翻译“字典”。此目录在生产中缓存,以最小化性能影响。
  1. 如果消息位于目录中,则返回翻译。如果不是,翻译器将返回原始消息。

提示

当翻译不在默认域中的字符串时(消息),则必须将域指定为的第三个参数反式()

1
翻译->反式(“欧宝娱乐app下载地址Symfony很棒”[],“管理”);

消息格式

有时候,包含变量的消息需要被转换:

1 2
/ /……翻译翻译->反式(“你好”的名字);

然而,为这个字符串创建一个翻译是不可能的,因为翻译器将尝试查找包含可变部分的消息(例如。“你好瑞恩”“你好,法比安”).

另一个复杂的问题是,当你的翻译可能是复数,也可能不是复数,这取决于一些变量:

1 2
有一个苹果。有5个苹果。

为了管理这些情况,Symfony遵循欧宝娱乐app下载地址ICU MessageFormat语法messageformat类。阅读更多如何使用ICU MessageFormat翻译消息

4.2

在Symfony 4.2中引入了对ICU MessageFormat的支持。欧宝娱乐app下载地址在此之前,多元化是由transChoice ()方法。

模板中的翻译

大多数时候,翻译发生在模板中。欧宝娱乐app下载地址Symfony为Twig和PHP模板提供了本地支持:

1
<h1>{%反式%}欧宝娱乐app下载地址Symfony很棒!{%endtrans%}h1>

在模板中使用翻译获取更多关于Twig标签和翻译过滤器的信息。

强制译者的语言环境

在翻译消息时,翻译人员将使用指定的区域设置或回退现场(如果需要的话)。你也可以手动指定要用于翻译的语言环境:

12 3 4 5 6 7 8 9 10 11 12 13 14
翻译->反式(“欧宝娱乐app下载地址Symfony很棒”[],“消息”“fr_FR”);翻译->transChoice ({0}没有苹果|{1}有一个苹果|]1,Inf[有%count%苹果'10[],“消息”“fr_FR”);

翻译内容自动提取与目录自动更新

翻译应用程序时最耗时的任务是提取要翻译的所有模板内容,并保持所有翻译文件的同步。欧宝娱乐app下载地址Symfony包含一个名为翻译:更新这可以帮助你完成以下任务:

1 2 3 4 5 6 7 8
#显示所有应该翻译为法语的消息PHP bin/控制台转换:update——dump-messages fr#更新法语翻译文件,使用该语言环境中缺少的字符串PHP bin/控制台转换:update——force fr#检查命令帮助查看它的选项(前缀,输出格式,域等)PHP bin/控制台翻译:update——帮助

翻译:更新命令查找以下文件中缺失的翻译:

4.3

从PHP文件中提取缺失的翻译字符串是在Symfony 4.3中引入的。欧宝娱乐app下载地址

翻译资源/文件名称和位置

欧宝娱乐app下载地址Symfony在以下默认位置查找消息文件(即翻译):

  1. 翻译/目录(在项目的根目录);
  2. src /资源/ <包名称> /翻译/目录;
  3. 资源/翻译/目录中的任何包。

4.2

使用src /资源/ <包名称> /翻译/用于存储翻译的目录在Symfony 4.2中已弃用。欧宝娱乐app下载地址方法中定义的目录default_path选项(即翻译/默认情况下)。

这里列出的位置优先级最高。也就是说,您可以覆盖前两个目录中任何一个包的翻译消息。

覆盖机制在键级别上工作:只有被覆盖的键需要列在优先级更高的消息文件中。当在消息文件中没有找到键时,转换器将自动退回到优先级较低的消息文件。

翻译文件的文件名也很重要:每个消息文件必须按照以下路径命名:domain.locale.loader

  • :将消息组织到组中的可选方法。除非应用程序的各个部分显式地彼此分离,否则建议只使用default消息域;
  • 语言环境:翻译的语言环境(例如:en_GB等);
  • 加载程序Symfon欧宝娱乐app下载地址y应该如何加载和解析文件(例如:xlfphpyaml等等)。

加载器可以是任何已注册加载器的名称。默认情况下,Symfon欧宝娱乐app下载地址y提供了许多加载器:

  • .yaml: YAML文件
  • .xlf: XLIFF文件;
  • . php:返回PHP数组;
  • . csv: CSV文件;
  • . json: JSON文件;
  • . ini: INI文件;
  • .datr: ICU资源包;
  • mo:机器对象格式;
  • .po:可移植对象格式;
  • .qt: QT Translations XML文件;

选择使用哪个加载器完全取决于您,这是一个品味问题。建议在简单项目中使用YAML,如果使用专门的程序或团队生成翻译,则使用XLIFF。

谨慎

每次创建消息目录(或安装包含翻译目录的包),请确保清除缓存,以便Symfony可以发现新的翻译资源:欧宝娱乐app下载地址

1
PHP bin/控制台缓存:清除

请注意

属性可以添加其他目录路径配置中的选项:

  • YAML
  • XML
  • PHP
1 2 3 4 5
#配置/包/ translation.yaml框架:翻译:道路:-' % kernel.project_dir % /定制/道路/ /翻译'

请注意

类的自定义类实现,也可以将翻译存储在数据库或任何其他存储中LoaderInterface接口。看到内置的Symfon欧宝娱乐app下载地址y服务标签标签以获取更多信息。

4.3

从Symfony 4.3开始欧宝娱乐app下载地址,当您创建一个新的翻译文件(或安装一个包含翻译文件的包)时,您不必使用该命令清除缓存PHP bin/控制台缓存:清除就像在以前的Symfony版本中一样。欧宝娱乐app下载地址

处理用户的语言环境

翻译是基于用户的语言环境进行的。读如何使用用户的语言环境了解更多如何处理它。

备用翻译区域设置

假设用户的语言环境是es_AR你在转换键欧宝娱乐app下载地址Symfony很棒.为了找到西班牙语翻译,Symfony实际上检查了几个地区的翻译资源欧宝娱乐app下载地址:

  1. 首先,Symf欧宝娱乐app下载地址ony在es_AR(阿根廷西班牙语)翻译资源(例如:messages.es_AR.yaml);
  2. 如果没有找到,Symfony将在父语言环欧宝娱乐app下载地址境中查找翻译,父语言环境仅为某些语言环境自动定义。在本例中,父区域设置为es_419(拉丁美洲西班牙语);
  3. 如果没有找到,Symfony将在欧宝娱乐app下载地址西文(西班牙语)翻译资源(例如:messages.es.yaml);
  4. 如果仍然没有找到翻译,Symfony将使用欧宝娱乐app下载地址回退参数,默认为(见配置).

请注意

当Symf欧宝娱乐app下载地址ony在给定的语言环境中找不到翻译时,它将把缺少的翻译添加到日志文件中。详细信息请参见框架配置参考(FrameworkBundle)

翻译数据库内容

数据库内容的翻译应由Doctrine通过可翻译扩展或者是可翻译行为(PHP 5.4 +)。有关更多信息,请参阅这些库的文档。欧宝体育电话

调试翻译

当您处理不同语言的许多翻译消息时,可能很难跟踪哪些翻译丢失了,哪些翻译不再使用。读如何查找缺失或未使用的翻译信息找出如何识别这些信息。

总结

使用Symfony欧宝娱乐app下载地址 Translation组件,创建国际化应用程序不再是一个痛苦的过程,可以归结为以下步骤:

  • 抽象应用程序中的消息,方法是将每个消息包装在反式()方法;
  • 通过创建翻译消息文件将每条消息翻译成多个地区。欧宝娱乐app下载地址Symfony发现并处理每个文件,因为它的名称遵循特定的约定;
  • 管理用户的语言环境,该语言环境存储在请求中,但也可以在用户的会话中设置。
此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。