我想知道是否有关于如何在 express.js 中实现多语言路由的最佳实践示例。我想使用accept-language
标题来获取浏览器语言,然后自动重定向到相应的语言路径,比如
www.foo.bar/de/startseite
或者
www.foo.bar/en/home
对此有何建议?
我想知道是否有关于如何在 express.js 中实现多语言路由的最佳实践示例。我想使用accept-language
标题来获取浏览器语言,然后自动重定向到相应的语言路径,比如
www.foo.bar/de/startseite
或者
www.foo.bar/en/home
对此有何建议?
我已经完成了以下操作:安装 i18n-node 模块并在 express js 中注册。这是代码。
var express = require('express')
, routes = require('./routes')
, http = require('http')
, i18n = require("i18n");
var app = express();
i18n.configure({
// setup some locales - other locales default to en silently
locales:['de', 'en'],
// disable locale file updates
updateFiles: false
});
app.configure(function(){
...
app.use(i18n.init);
...
});
// register helpers for use in templates
app.locals({
__i: i18n.__,
__n: i18n.__n
});
在此之后设置以下内容以获取所有请求
// invoked before each action
app.all('*', function(req, res, next) {
// set locale
var rxLocal = /^\/(de|en)/i;
if(rxLocal.test(req.url)){
var arr = rxLocal.exec(req.url);
var local=arr[1];
i18n.setLocale(local);
} else {
i18n.setLocale('de');
}
// add extra logic
next();
});
app.get(/\/(de|en)\/login/i, routes.login);
也许这有帮助。
我只是直接以检测到的语言提供内容。
例如,example.com/home
以最佳可用的方式提供主页Accept-Language
(如果您在网站本身上提供语言选择选项,可能会被 cookie 覆盖)。
您需要确保响应的Vary:
标题包括Accept-Language
.
IMO,在 URI 中包含语言代码是一个丑陋的黑客。RFC 的意图是单个资源(您的主页)普遍由单个 URI 表示。为 URI 返回的实体可能会根据其他信息(例如语言首选项)而有所不同。
考虑当讲德语的用户复制 URL 并将其发送给讲英语的用户时会发生什么。该收件人更愿意以英文查看您的网站,但由于他收到了指向 的链接example.com/de/startseite
,因此他直接访问了德文版本。
显然,这对于用户在地址栏中看到的内容的完全国际化并不理想(因为home是英文),但它更符合 RFC 的意图,我认为它对用户更有效,尤其是作为链接在电子邮件/社交/其他地方传播。
@miro 的答案非常好,但可以在单独文件中的以下中间件中进行改进(如 @ebohlman 建议的那样)。
module.exports = {
configure: function(app, i18n, config) {
app.locals.i18n = config;
i18n.configure(config);
},
init: function(req, res, next) {
var rxLocale = /^\/(\w\w)/i;
if (rxLocale.test(req.url)){
var locale = rxLocale.exec(req.url)[1];
if (req.app.locals.i18n.locales.indexOf(locale) >= 0)
req.setLocale(locale);
}
//else // no need to set the already default
next();
},
url: function(app, url) {
var locales = app.locals.i18n.locales;
var urls = [];
for (var i = 0; i < locales.length; i++)
urls[i] = '/' + locales[i] + url;
urls[i] = url;
return urls;
}
};
也在github的示例项目中。
中间件具有三个功能。第一个是一个小助手,它配置i18n-node
并保存设置app.locals
(还没有弄清楚如何从i18n-node
它自己访问设置)。
主要的是第二个,它从 url 获取语言环境并将其设置在请求对象中。
最后一个是帮助器,对于给定的 url,它返回一个包含所有可能语言环境的数组。例如,用我们调用它'/about'
会得到['/en/about', ..., '/about']
.
在app.js
:
// include
var i18n = require('i18n');
var services = require('./services');
// configure
services.i18nUrls.configure(app, i18n, {
locales: ['el', 'en'],
defaultLocale: 'el'
});
// add middleware after static
app.use(services.i18nUrls.init);
// router
app.use(services.i18nUrls.url(app, '/'), routes);
可以从任何带有i18n-node
's 的控制器访问区域设置req.getLocale()
。
@josh3736 推荐的内容肯定符合 RFC 等。尽管如此,这对于许多 i18n 网站和应用程序来说是一个相当普遍的要求,甚至 Google 也尊重本地化并在不同 url 下提供的相同资源(可以在网站管理员工具中验证这一点)。不过,我建议在 lang 代码之后使用相同的别名,例如/en/home
等/de/home
。
不确定您计划如何组织或共享内容,但您可以将正则表达式与快速路由一起使用,然后提供不同的模板。像这样的东西:
app.get(/^\/(startseite|home)$/, function(req, res){
});
我做的一件事是用子域组织我的内容,然后使用中间件从基于拆分 url 的数据库中获取内容,但它们都共享相同的路由和模板。
编写一个中间件函数,解析任何“Accept-Language”标头,如果没有这样的标头,则将请求级局部变量设置为具有默认值(如“en”)的适当代码(如两字母语言代码)或者您不支持列出的任何语言。在您的路线中,检索本地文件并将其附加到任何模板文件名上,如果除了模板选择之外还有任何与语言相关的处理,则在其上进行分支。