nodejs 国际化 ,多语言
什么是多语言?
我们平时访问一些文档类型的网站时,经常可以看到页面右上角有一个下拉框用来选择当前页面支持的语言,并在选中后将整个网页的内容切换为选中的语言,这就是项目中的多语言,多语言可以根据浏览器请求发送的语言类型在服务器进行设置,也可以在请求服务器时返回多种语言,并根据权重和浏览器的支持情况进行选择和渲染。
功能描述
在本文中我们通过客户端向服务器发送请求告诉服务器客户端所支持的语言及权重,服务器检索语言包并根据客户端发送的语言类型和权重返回对应语言的内容。
在这个过程中客户端向服务器发送请求需要使用请求头 Accept-Language
,值中设置语言类型和权重,语言与语言之间使用 ,
隔开,语言与权重之间使用 ;
隔开,权重用 q
表示,与值用 =
隔开,如果权重值为 1
则可省略(最大值),值的格式为 zh-CN, zh;q=0.7, en;q=0.8, fr;q=0.1
。
服务器响应时,应通过响应头告诉浏览器返回的内容为何种语言,响应头为 Content-Language
, 值的格式为 zh-CN, en
,多个语言之间使用 ,
隔开。
服务器的实现
// 文件:server.js
const http = require("http");
const querystring = require("querystring");
// 语言包
let languagesPackage = {
"zh-CN": "你好",
en: "Hello",
fr: "Bonjour"
};
// 默认语言为英语
languagesPackage.defaultLanguage = "en";
// 创建服务器
const server = http.createServer((req, res) => {
// 获取请求头中的语言和权重
let languages = req.headers["accept-language"];
// 如果客户端设置了语言
if (languages) {
// 解析语言为 [{ name: 'zh-CN', q: 1 }, { name: 'en', q: '0.8' }] 格式
let lans = languages
.split(",")
.map(lang => {
let [name, q = 1] = Object.keys(
querystring.parse(lang.tirm(), ";q=")
);
return { name, q };
})
.sort((a, b) => b.q - a.q); // 并按照权重逆序排序
// 循环检测 languagesPackage 是否存在客户端的语言
for (let i = 0; i < lans.length; i++) {
let { name } = lans[i];
let content = languagesPackage[name];
// 如果存在直接设置响应头并返回内容
if (content) {
res.setHeader("Content-Type", name);
return res.end(content);
}
}
}
// 如果客户端没设置语言活语言找不到时返回服务器设置的默认语言
res.setHeader("Content-Type", languagesPackage.defaultLanguage);
res.end(languagesPackage[languagesPackage.defaultLanguage]);
});
server.listen(3000, () => {
console.log("server start 3000");
});
其实上面服务器和客户端配合实现多语言的思路就是客户端向服务器发送 Accept-Language
告诉服务器需要的语言和权重,服务器解析后根据权重从大到小排序,然后循环判断语言包中是否含有客户端需要的语言,如果有,则中断循环直接设置响应头和返回对应内容,如果不存在客户端的需要的语言或者客户端没有向后台发送 Accept-Language
则返回服务器默认设置的语言类型和内容。
验证多语言
为了方便我们使用 curl
模拟客户端向服务器发送请求查看返回内容是否正确,之所以使用 curl
是因为只发送验证的请求,方便设置 Accept-Language
请求头,更灵活的控制多语言的类型和权重。
启动服务器 server.js
,打开命令行窗口,输入下面的命令执行,查看返回命令行响应体中的内容和设置的语言是否对应。
curl -v --header “Accept-Language: zh-CN, zh;q=0.7, en;q=0.8, fr;q=0.1” http://localhost:3000
总结
这样我们就实现了一个简单的多语言,其实真正的多语言在服务器是需要做繁琐的解析和性能优化的(只解析界面有的单词返回,保证响应体中的内容最小),在前端可以通过 JavaScript 的库 il8n
(国际化语言包)来实现。