Creation:2026-09-19Last update:2026-09-19
将此文档参考到您的 AI 助手ChatGPTClaudeDeepSeekGoogle AI modeGeminiPerplexityMistralGrok
使用您最喜欢的AI助手总结文档,并引用此页面和AI提供商
版本历史
- "intlayer 中间件初始文档"v9.5.52026/9/19
此页面的内容已使用 AI 翻译。
查看英文原文的最新版本编辑此文档
如果您有改善此文档的想法,请随时通过在GitHub上提交拉取请求来贡献。
文档的 GitHub 链接Copy
复制文档 Markdown 到剪贴板
intlayer 中间件
intlayer 中间件函数在 Remix 3 应用程序中配置按请求进行的国际化处理。它检测每个传入请求的语言环境,应用 URL 重定向规则,并将语言环境状态保存在请求上下文中。
使用方法
在 Remix 路由器中注册中间件:
src/server.ts
复制代码
复制代码到剪贴板
工作原理
中间件对每个传入请求执行以下任务:
- 语言环境检测: 根据 Intlayer 配置,从 URL 路径前缀(例如
/zh/about)、Cookie 或Accept-Language请求头中提取语言环境。 - URL 重定向: 如果请求的路径缺少语言环境前缀,并且配置要求前缀路由,中间件将返回重定向响应 (302/307/308) 到带前缀的相应 URL。
- 填充请求上下文: 使用
Intlayer键将当前解析的语言环境保存到 Remix 请求上下文中,使钩子 (useLocale,useIntlayer,useDictionary) 能够透明使用。 - Cookie 管理: 在需要持久保存用户首选语言环境时设置
Set-Cookie标头。
