You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

GF框架支持I18N国际化,由gi18n模块实现。

使用方式

import "github.com/gogf/gf/i18n/gi18n"

接口文档

https://godoc.org/github.com/gogf/gf/i18n/gi18n

使用配置

文件格式

gi18n国际化模块支持框架通用的五种配置文件格式:xml/ini/yaml/toml/json。同样的,和配置管理模块一样,框架推荐使用toml文件格式。

文件目录

默认情况下gi18n会自动读取当前项目根目录下的i18n目录,默认将该目录作为国际化转译文件存储目录。开发者也可以通过SetPath方法自定义i18n文件的存储目录路径。

i18n目录下可以直接按照国际化名称命名的文件如:en.toml/ja.toml/zh-CN.toml;也可以给定国际化名称目录,目录下随意自定义配置文件,如:en/editor.toml/en/user.tomlzh-CN/editor.toml/zh-CN/user.toml

例如,以下的i18n目录结构以及文件格式都是支持的:

├── i18n
│   ├── en.toml
│   ├── ja.toml
│   ├── ru.toml
│   ├── zh-CN.toml
│   └── zh-TW.toml
├── i18n-dir
│   ├── en
│   │   ├── hello.toml
│   │   └── world.toml
│   ├── ja
│   │   ├── hello.yaml
│   │   └── world.yaml
│   ├── ru
│   │   ├── hello.ini
│   │   └── world.ini
│   ├── zh-CN
│   │   ├── hello.json
│   │   └── world.json
│   └── zh-TW
│       ├── hello.xml
│       └── world.xml
└── i18n-file
    ├── en.toml
    ├── ja.yaml
    ├── ru.ini
    ├── zh-CN.json
    └── zh-TW.xml

资源管理器

gi18n默认支持资源管理器,也就是说,默认情况下会从gres配置管理器中检索i18n目录,或者开发者设置的i18n目录路径。

对象创建

大多数场景下,我们推荐使用g.I18n单例对象,并可自定义配置不同的单例对象,但是需要注意的是,单例对象的配置修改是全局有效的。例如:

g.I18n().T("{#hello} {#world}")

其次,我们也可以模块化独立使用gi18n模块,通过gi18n.New()方法创建独立的i18n对象,然后开发者自行进行管理。例如:

i18n := gi18n.New()
i18n.T("{#hello} {#world}")

常用方法

T方法

T方法为Translate方法的别名,也是大多数时候我们推荐使用的方法名称。T方法可以给定关键字名称,也可以直接给定模板内容,将会被自动转译并返回转译后的字符串内容。

此外,T方法可以通过第二个语言参数指定需要转译的目标语言名称,该名称需要和配置文件/路径中的名称一致,往往是标准化的国际化语言缩写名称如:en/ja/ru/zh-CN/zh-TW等等。否则,将会自动使用Manager转译对象中设置的语言进行转译。

方法定义:

// T translates <content> with configured language and returns the translated content.
// The parameter <language> specifies custom translation language ignoring configured language.
func T(content string, language ...string) string

关键字转译

关键字的转译直接给T方法传递关键字即可,例如:T("hello")T("world")

模板内容转译

T方法支持模板内容转换,模板中的关键字默认使用{#}标签进行包含,模板解析时将会自动替换该标签中的关键字内容。使用示例:

1、转译文件

ja.toml

hello = "こんにちは" 
world = "世界"

ru.toml

hello = "Привет" 
world = "мир"

zh-CN.toml 

hello = "你好" 
world = "世界"

2、示例代码 

package main

import (
	"fmt"

	"github.com/gogf/gf/i18n/gi18n"
)

func main() {
	i18n := gi18n.New()
	i18n.SetLanguage("en")
	fmt.Println(i18n.Translate(`hello`))
	fmt.Println(i18n.Translate(`GF says: {#hello}{#world}!`))

	i18n.SetLanguage("ja")
	fmt.Println(i18n.Translate(`hello`))
	fmt.Println(i18n.Translate(`GF says: {#hello}{#world}!`))

	i18n.SetLanguage("ru")
	fmt.Println(i18n.Translate(`hello`))
	fmt.Println(i18n.Translate(`GF says: {#hello}{#world}!`))

	fmt.Println(i18n.Translate(`hello`, "zh-CN"))
	fmt.Println(i18n.Translate(`GF says: {#hello}{#world}!`, "zh-CN"))
}

执行后,终端输出为:

Hello
GF says: HelloWorld!
こんにちは
GF says: こんにちは世界!
Привет
GF says: Приветмир!
你好
GF says: 你好世界!

Tf方法

TfTranslateFormat的别名,该方法支持格式化转译内容,字符串格式化语法参考标准库fmt包的Sprintf方法。

方法定义:

// Tf translates, formats and returns the <format> with configured language
// and given <values>.
func Tf(format string, values ...interface{}) string

我们来看一个简单的示例。

1、转译文件

en.toml 

OrderPaid = "You have successfully complete order #%d payment, paid amount: ¥%0.2f."

 zh-CN.toml 

OrderPaid = "您已成功完成订单号 #%d 支付,支付金额¥%.2f。"

2、示例代码

package main

import (
	"fmt"
	"github.com/gogf/gf/i18n/gi18n"
)

func main() {
	var (
		orderId     = 865271654
		orderAmount = 99.8
	)

	i18n := gi18n.New()
	t.SetLanguage("en")
	fmt.Println(i18n.Tf(`{#OrderPaid}`, orderId, orderAmount))

	t.SetLanguage("zh-CN")
	fmt.Println(i18n.Tf(`{#OrderPaid}`, orderId, orderAmount))
}

执行后,终端输出为:

You have successfully complete order #865271654 payment, paid amount: ¥99.80.
您已成功完成订单号 #865271654 支付,支付金额¥99.80。

为方便演示,该示例中对支付金额的处理比较简单,在实际项目中往往需要在业务代码中对支付金额的单位按照区域做自动转换,再渲染i18n显示内容。

Tfl方法

TflTranslateFormatLang的别名,该方法支持格式化转译内容,并可指定转译的语言,字符串格式化语法参考标准库fmt包的Sprintf方法。

方法定义:

// Tfl translates, formats and returns the <format> with configured language
// and given <values>. The parameter <language> specifies custom translation language ignoring
// configured language. If <language> is given empty string, it uses the default configured
// language for the translation.
func Tfl(language string, format string, values ...interface{}) string

我们将上面的示例做些改动来演示。

1、转译文件

en.toml 

OrderPaid = "You have successfully complete order #%d payment, paid amount: ¥%0.2f."

zh-CN.toml

OrderPaid = "您已成功完成订单号 #%d 支付,支付金额¥%.2f。"

2、示例代码

package main

import (
	"fmt"
	"github.com/gogf/gf/frame/g"
)

func main() {
	var (
		orderId     = 865271654
		orderAmount = 99.8
	)
	fmt.Println(g.I18n().Tfl(`en`, `{#OrderPaid}`, orderId, orderAmount))
	fmt.Println(g.I18n().Tfl(`zh-CN`, `{#OrderPaid}`, orderId, orderAmount))
}

执行后,终端输出为:

You have successfully complete order #865271654 payment, paid amount: ¥99.80.
您已成功完成订单号 #865271654 支付,支付金额¥99.80。



为方便演示,该示例中对支付金额的处理比较简单,在实际项目中往往需要在业务代码中对支付金额的单位按照区域做自动转换,再渲染i18n显示内容。


I18N与视图引擎

gi18n默认已经集成到了GF框架的视图引擎中,直接在模板文件/内容中使用gi18n的关键字标签即可。

此外,也可以通过设置模板变量I18nLanguage设置当前模板的解析语言,该变量可以控制不同的模板内容按照不同的国际化语言进行解析。

使用示例:

package main

import (
	"github.com/gogf/gf/frame/g"
	"github.com/gogf/gf/net/ghttp"
)

func main() {
	s := g.Server()
	s.BindHandler("/", func(r *ghttp.Request) {
		r.Response.WriteTplContent(`GF says: {#hello}{#world}!`, g.Map{
			"I18nLanguage": r.Get("lang", "zh-CN"),
		})
	})
	s.SetPort(8199)
	s.Run()
}

执行后,访问以下页面,将会输出:

  1. http://127.0.0.1:8199
    GF says: 你好世界!
  2. http://127.0.0.1:8199/?lang=ja
    GF says: こんにちは世界!



Content Menu

  • No labels