翻译
编辑该页面警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 3.0,不再维护。
读这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。
翻译
“国际化”这个词(通常缩写i18n)是指抽象成字符串的过程和其他应用程序的特定部分为一层,在那里他们可以被翻译和转换根据用户的语言环境(即语言和国家)。对于文本,这意味着包装每一个函数能够翻译文本(或“消息”)为用户的语言:
1 2 3 4 5 6 7 8
/ /文本将* *总是用英文打印转储(“Hello World”);死();/ /文本可以转化为最终用户的语言或/ /默认为英文转储(美元翻译- >反式(“Hello World”));死();请注意
这个词语言环境大概是指用户的语言和国家。它可以是任何字符串,您的应用程序使用管理翻译和其他格式的差异(如货币格式)。的ISO 639 - 1语言代码,下划线(_),那么ISO 3166 - 1α2国家代码(如。fr_FR法国建议/法国)。
在本章中,您将了解如何使用翻译组件在Symfony框架。ob娱乐下载你可以阅读的翻译组件文档欧宝官网下载app学习更多。总的来说,这个过程有几个步骤:
- 启用和配置ob娱乐下载Symfony的翻译服务;
- (即抽象的字符串。“消息”),在调用包装它们
翻译(“翻译”); - 创建翻译资源/文件每种受支持的语言环境,将每个消息的应用程序;
- 确定,设置和管理用户的语言环境请求和选择在用户的整个会话。
配置
翻译由一个处理翻译服务,使用用户的语言环境来查找并返回翻译信息。在使用它之前,启用翻译在你的配置:
- YAML
- XML
- PHP
1 2 3
# app / config / config.yml框架:翻译:{回退:(en)}看到翻译细节的回退键和什么Symfony的时ob娱乐下载候不找一个翻译。
翻译中所使用的语言环境是一个存储在请求。这通常是通过设置_locale在你的路线(见属性如何处理用户的语言环境)。
基本的翻译
翻译文本是通过的翻译服务(翻译)。翻译的文本块(称为消息),用反式()方法。例如,假设你翻译一个简单的消息从一个控制器:
1 2 3 4 5 6 7 8 9
/ /……使用ob娱乐下载\组件\HttpFoundation\响应;公共函数indexAction(){美元翻译=美元这- >get (“翻译”)- >反式(Sob娱乐下载ymfony是伟大的);返回新响应(美元翻译);}执行这段代码时,Symfony将尝试翻译消息基于“Symob娱乐下载fony是伟大的”语言环境的用户。为此,您需要告诉Symfony如何翻译消息通过“翻译资源”,这通常是一ob娱乐下载个文件,它包含一组翻译对于一个给定的语言环境。这种“字典”的翻译可以在几个不同的格式,创建XLIFF被推荐的格式:
- XML
- YAML
- PHP
1 2 3 4 5 6 7 8 9 10 11 12
< !- - - - - -- - - - - -messages.fr.xlf- - - - - -- >< ?xml version = " 1.0 " ? ><xliff版本=“1.2”xmlns=“urn: oasis:名称:tc: xliff文档:1.2”><文件通过读=“en”数据类型=“明文”原始=“file.ext”><身体><trans-unitid=“ob娱乐下载symfony_is_great”><源>ob娱乐下载Symfony是伟大的< /源><目标>我Symfonob娱乐下载y< /目标>< /trans-unit>< /身体>< /文件>< /xliff>这些文件应该安装在哪里的信息,明白了翻译。
现在,如果用户的语言环境是法国人的语言(如。fr_FR或fr_BE),消息将被翻译成我Symfonob娱乐下载y。你也可以翻译你的消息模板。
消息占位符
有时,一个消息包含一个变量需要翻译:
1 2 3 4 5 6 7 8
使用ob娱乐下载\组件\HttpFoundation\响应;公共函数indexAction(美元的名字){美元翻译=美元这- >get (“翻译”)- >反式(“你好”。美元的名字);返回新响应(美元翻译);}然而,这个字符串创建一个翻译是不可能的因为翻译将尝试查找确切的消息,包括可变部分(如。“你好瑞恩”或“你好,法比安”)。
多元化的案例
另一个问题是当你有可能是也可能不是复数翻译,基于一些变量:
1 2
有一个苹果。有5个苹果。为了处理这个问题,使用transChoice ()法或者transchoice在你的标签/过滤器模板。
有关更多信息,请参见使用翻译在翻译组件文档。欧宝官网下载app
翻译的模板
大多数时候,翻译出现在模板。ob娱乐下载Symfony提供本机支持树枝和PHP模板。
树枝模板
ob娱乐下载Symfony提供了专门的树枝标签(反式和transchoice)帮助信息的翻译静态文本块:
1 2 3 4 5
{%反式%}你好% %{%endtrans%}{%transchoice数%}{0}没有苹果| |{1}有一个苹果)1,正有%数%苹果{%endtranschoice%}的transchoice标签自动获取%数%从当前上下文变量,将其传递到翻译。这种机制只适用后当你使用一个占位符% var %模式。
谨慎
的% var %符号的占位符时需要翻译在树枝模板使用标签。
提示
如果你需要使用字符(百分比%)在一个字符串,逃避它增加一倍:{%反式%}%:% % % % % {% endtrans %}
你也可以指定消息域和通过一些额外的变量:
1 2 3 4 5 6 7
{%反式与{%名称%的:‘法’}从“应用”%}你好% %{%endtrans%}{%反式与{%名称%的:‘法’}从“应用”到“fr”%}你好% %{%endtrans%}{%transchoice数与{%名称%的:‘法’}从“应用”%}{0}% %的名字,没有苹果|{1}% %的名字,有一个苹果| 1,正[%名称%,%数%苹果{%endtranschoice%}的反式和transchoice过滤器可以用来翻译变量文本和复杂的表达式:
1 2 3 4 5 6 7
{{消息|反式}}{{消息| transchoice (5)}}{{消息|反式({%名称%的:‘法’},“应用程序”)}}{{{消息| transchoice(5日‘%名称%’:‘法’},“应用程序”)}}提示
使用翻译标记或过滤器具有相同的效果,但有一个微妙的差异:自动输出逃避只是使用一个过滤器应用于翻译。换句话说,如果你需要确保你的信息是翻译不输出了,你必须应用生翻译后过滤器过滤:
1 2 3 4 5 6 7 8 9 10
{#标记之间的文本翻译从来不是逃脱了#}{%反式%}<h3>喷火< /h3>{%endtrans%}{%集消息= ' < h3 > foo < / h3 > ' %}{#通过一个过滤器字符串和变量翻译默认了#}{{消息反式| |生}}{{< h3 > < / h3 >酒吧的反式| |生}}提示
你可以设置整个树枝模板的翻译领域一个标签:
1
{%trans_default_domain“应用程序”%}请注意,这仅影响当前模板,而不是任何“包括”模板(为了避免副作用)。
PHP模板
翻译服务可通过在PHP模板翻译助手:
1 2 3 4 5 6 7
< ? php回声美元视图(“翻译”]- >反式(Sob娱乐下载ymfony是伟大的)? >< ? php回声美元视图(“翻译”]- >transChoice (“{0}没有苹果|{1}有一个苹果|)1,正[有%数%苹果',10,数组(“%数%”= >10))? >翻译资源/文件名称和位置
ob娱乐下载Symfony查找消息文件(即翻译)在接下来的默认位置:
- 的
应用程序/资源/翻译目录; - 的
应用程序/资源/ <包名称> /翻译目录; - 的
资源/翻译/目录里面的包。
这里列出的位置是最高的优先级。也就是说,您可以重写翻译消息包的顶部2目录。
覆盖机制的关键水准:只有覆盖键需要列在一个更高的优先级消息文件。当一个关键消息文件中没有找到,译者会自动退回到低优先级消息文件。
翻译文件的文件名也很重要:每个消息文件必须命名根据以下路径:domain.locale.loader:
- 域:一个可选的方法来组织信息分组(如。
管理,导航或默认消息)- - -看翻译组件; - 语言环境:翻译的语言环境(如
en_GB,在等); - 加载程序:Symfoob娱乐下载ny如何加载和解析文件(如。
xlf,php,yml等等)。
装载机可以任何注册加载程序的名称。默认情况下,Symfonob娱乐下载y提供了许多加载器,包括:
xlf:XLIFF文件;php:PHP文件;yml:YAML文件。
使用哪个装载机的选择完全取决于你,是一种品味。推荐的方法是使用xlf翻译。更多的选项,请参阅翻译组件。
请注意
您可以添加其他目录路径配置选项:
- YAML
- XML
- PHP
1 2 3 4 5
# app / config / config.yml框架:翻译:道路:- - - - - -' % kernel.root_dir % / . . /翻译'请注意
你也可以翻译存储在一个数据库,或任何其他存储通过提供一个自定义类实现LoaderInterface接口。看到依赖注入的标签标签的更多信息。
谨慎
每次你创建一个新翻译资源(或安装一个包,其中包括翻译资源),一定要清楚你的缓存,这样Symfony会发现新的翻译资源:ob娱乐下载
1
美元php bin /控制台缓存:清楚回退翻译的地方
想象一下,用户的区域设置fr_FR那你翻译的关键ob娱乐下载Symfony是伟大的。找到法语翻译,Symfony会检查翻译资源几个地区:ob娱乐下载
- 首先,Symfob娱乐下载ony查找翻译的
fr_FR翻译资源(如。messages.fr_FR.xlf); - 如果没有发现,Symfony查找翻译的ob娱乐下载
fr翻译资源(如。messages.fr.xlf); - 如果翻译还没有发现,Symfony使用ob娱乐下载
回退默认的配置参数在(见配置)。
请注意
当Symfob娱乐下载ony不找一个翻译在给定的区域,它会
失踪的翻译添加到日志文件中。的细节,
看到FrameworkBundle配置(“框架”)。
处理用户的语言环境
翻译会根据用户的语言环境。读如何处理用户的语言环境了解更多关于如何处理它。
调试翻译
当你有许多工作在不同语言翻译消息,很难跟踪哪些翻译是失踪,哪些不习惯了。读如何找到丢失或未使用的翻译消息吗找出如何识别这些消息。
总结
Symfony翻译ob娱乐下载组件,创建国际化应用程序不再需要一个痛苦的过程,可以归结为几个基本步骤:
- 文摘信息在您的应用程序通过包装的反式()或transChoice ()方法(了解这个使用翻译);
- 每个消息转化为多个地区通过创建翻译消息文件。ob娱乐下载Symfony发现每个文件和流程,因为它遵循一个特定的会议名称;
- 管理用户的语言环境,这是存储在请求,但也可以设置用户的会话。
