什么是多语言?

我们平时访问一些文档类型的网站时,经常可以看到页面右上角有一个下拉框用来选择当前页面支持的语言,并在选中后将整个网页的内容切换为选中的语言,这就是项目中的多语言,多语言可以根据浏览器请求发送的语言类型在服务器进行设置,也可以在请求服务器时返回多种语言,并根据权重和浏览器的支持情况进行选择和渲染。

功能描述

在本文中我们通过客户端向服务器发送请求告诉服务器客户端所支持的语言及权重,服务器检索语言包并根据客户端发送的语言类型和权重返回对应语言的内容。

在这个过程中客户端向服务器发送请求需要使用请求头 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');

// 语言包
const languagesPackage = {
  'zh-CN': '你好',
  'en': 'Hello',
  'fr': 'Bonjour'
};

// 默认语言为英语
languagesPackage.defaultLanguage = 'en';

// 创建服务器
const server = http.createServer((req, res) => {
  // 获取请求头中的语言和权重
  const languages = req.headers['accept-language'];

  // 如果客户端设置了语言
  if (languages) {
    // 解析语言为 [{ name: 'zh-CN', q: 1 }, { name: 'en', q: '0.8' }] 格式
    const lans = languages.split(',').map(lang => {
      const [name, q = 1] = Object.keys(querystring.parse(lang.tirm(), ';q=', true));
      return { name, q };
    }).sort((a, b) => b.q - a.q); // 并按照权重逆序排序

    // 循环检测 languagesPackage 是否存在客户端的语言
    for (let i = 0; i < lans.length; i++) {
      const { name } = lans[i];
      const 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 则返回服务器默认设置的语言类型和内容。

通常多语言的语言包是通过其他服务和一些其他的规则请求回来的,我们为了方便是在服务里通过 config 写死了。

验证多语言

为了方便我们使用 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

总结

这样我们就实现了一个简单的多语言服务,其实真正的多语言在服务器是需要做繁琐的解析和性能优化(只解析界面有的单词返回,保证响应体中的内容最小),也可以通过配合成熟的 il8n(国际化语言包)库来实现。