翻译组件
编辑该页面警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 4.1,不再维护。
读这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。
翻译组件
翻译组件提供国际化应用程序的工具。
安装
1
美元作曲家需要symfony /翻译ob娱乐下载或者,您可以克隆的https://github.com/ob娱乐下载symfony/translation存储库。
请注意
如果你安装这个组件之外的Symfony应用程序,你必须要求ob娱乐下载供应商/ autoload.php文件在你的代码,使作曲家提供的类加载机制。读这篇文章为更多的细节。
另请参阅
这篇文章解释了如何使用翻译功能作为一个独立的组件在任何PHP应用程序。读了翻译篇文章,了解如何在Symfony应用程序国际化和管理用户的语言环境。ob娱乐下载
构建翻译
的主要访问点翻译组件翻译。您可以使用它之前,您需要配置它,翻译(称为加载消息信息目录)。
配置
的构造函数翻译类需要一个参数:地区:
1 2 3
使用ob娱乐下载\组件\翻译\翻译;美元翻译=新翻译(“fr_FR”);请注意
这里的语言环境设置要使用的缺省语言环境。你可以覆盖这个地区当翻译字符串。
请注意
这个词语言环境大概是指用户的语言和国家。它可以是任何字符串,您的应用程序使用管理翻译和其他格式的差异(如货币格式)。的ISO 639 - 1语言代码,下划线(_),那么ISO 3166 - 1α2国家代码(如。fr_FR法国建议/法国)。
加载消息目录
内部的消息存储在消息目录翻译类。消息目录就像字典翻译为一个特定的语言环境。
翻译组件使用类加载器加载目录。在同一地区,您可以加载多个资源将被合并到一个目录。
组件提供了一些默认的加载器,您可以创建自己的装载机。默认加载程序:
- ArrayLoader——加载目录从PHP数组。
- CsvFileLoader——从CSV文件加载目录。
- IcuDatFileLoader从资源包加载目录。
- IcuResFileLoader从资源包加载目录。
- IniFileLoader——从ini文件加载目录。
- MoFileLoader——从gettext加载目录文件。
- PhpFileLoader从PHP文件加载目录。
- PoFileLoader——从gettext加载目录文件。
- QtFileLoader——从QT XML文件加载目录。
- XliffFileLoader——从Xliff文件加载目录。
- JsonFileLoader——从JSON文件加载目录。
- YamlFileLoader——从Yaml文件(需要装载目录Yaml组件)。
所有的文件加载器要求配置组件。
你也可以创建自己的装载机,支持的格式不是已经默认加载器之一。
首先,你应该添加一个或更多的加载器翻译:
1 2
/ /……美元翻译- >addLoader (“数组”,新ArrayLoader ());第一个参数是装载机的名字,您可以参考翻译,第二个参数是加载器本身的一个实例。在此之后,您可以添加您的资源使用正确的加载程序。
加载消息ArrayLoader
加载消息可以通过调用完成addResource ()。第一个参数是装载机的名字(这是第一个参数addLoader ()方法),第二个是资源,第三个参数是语言环境:
1 2 3 4
/ /……美元翻译- >addResource (“数组”,(“Hello World !”= >“你好”),“fr_FR”);与文件加载器加载信息
如果你使用一个文件的加载器,你也应该使用addResource ()方法。唯一的区别是,你应该把资源文件的文件名作为第二个参数,而不是数组:
1 2 3
/ /……美元翻译- >addLoader (yaml的,新YamlFileLoader ());美元翻译- >addResource (yaml的,“路径/ / messages.fr.yaml”,“fr_FR”);翻译过程
翻译的信息,译者使用以下过程:
- 加载目录翻译消息从翻译资源的定义
语言环境(如。fr_FR)。的消息翻译组件也加载并添加到目录,如果他们不存在。最终的结果是一个大型的“词典”翻译; - 如果消息位于目录,返回翻译。如果没有,翻译返回原始消息。
你开始这个过程通过调用反式()或transChoice ()。然后,译者寻找适当的消息目录内的精确字符串并返回(如果它存在的话)。
回退地区
如果消息不是位于目录的具体语言环境,译者将一个或多个目录的回退场所。例如,假设你想翻译成fr_FR地区:
- 首先,翻译找的翻译
fr_FR语言环境; - 如果没有发现,译者寻找翻译的
fr语言环境; - 如果翻译还没有发现,译者使用了一个或多个后备区域设置明确的翻译。
(3),可以通过调用设置回退的地方setFallbackLocales ():
1 2
/ /……美元翻译- >setFallbackLocales ([“en”]);使用消息域
如您所见,消息文件被组织成不同地区,他们的翻译。进一步消息文件也可以组织到“域”。
域的第四个参数指定addResource ()方法。默认的域名是消息。例如,假设,组织,翻译被分为三个不同的领域:消息,管理和导航。法语翻译将加载这样的:
1 2 3 4 5 6 7 8 9 10 11
/ /……美元翻译- >addLoader (“xlf”,新XliffFileLoader ());美元翻译- >addResource (“xlf”,“messages.fr.xlf”,“fr_FR”);美元翻译- >addResource (“xlf”,“admin.fr.xlf”,“fr_FR”,“管理”);美元翻译- >addResource (“xlf”,“navigation.fr.xlf”,“fr_FR”,“导航”);当翻译的字符串不是在默认域(消息),您必须指定域的第三个参数反式():
1
美元翻译- >反式(Sob娱乐下载ymfony是伟大的[],“管理”);ob娱乐下载Symfony将寻找的信息管理域的指定的场所。
