您可能希望为您的应用支持的每种语言使用不同的域名。
以下是实现此目的的方法:
differentDomains
选项设置为 true
locales
选项配置为对象数组,每个对象具有一个 domain
键,其值是您希望为该语言环境使用的域名。可选地包括一个端口(如果不是标准端口)和/或一个协议。如果未提供协议,则会尝试进行自动检测,但在某些情况下(例如页面是静态生成时)这可能无法正常工作。detectBrowserLanguage
设置为 false
。启用时(默认启用),用户第一次访问时可能会被重定向到不同的域名。如果希望确保访问给定域名始终显示相应语言环境的页面,则设置为 false
。export default defineNuxtConfig({
i18n: {
locales: [
{
code: 'en',
domain: 'mydomain.com'
},
{
code: 'es',
domain: 'es.mydomain.com'
},
{
code: 'fr',
domain: 'fr.mydomain.com'
},
{
code: 'pl',
domain: 'http://pl.mydomain.com'
},
{
code: 'ua',
domain: 'https://ua.mydomain.com'
}
],
differentDomains: true
// 或仅在生产环境中启用该选项
// differentDomains: (process.env.NODE_ENV === 'production')
}
})
在使用不同域名时,您的语言切换器应使用常规的 <a>
标签:
<script setup>
const { locale, locales } = useI18n()
const switchLocalePath = useSwitchLocalePath()
const availableLocales = computed(() => {
return locales.value.filter(i => i.code !== locale.value)
})
</script>
<template>
...
<a v-for="locale in availableLocales" :href="switchLocalePath(locale.code)" :key="locale.code">
{{ locale.code }}
</a>
...
</template>
有时需要在不同环境中更改域名,例如,在暂存和生产环境中。
由于 nuxt.config.ts
在构建时使用,因此需要为不同环境创建不同的构建。
export const localeDomains = {
uk: process.env.DOMAIN_UK,
fr: process.env.DOMAIN_FR
}
import { localeDomains } from './locale-domains.config'
export default defineNuxtConfig({
modules: ['@nuxtjs/i18n'],
i18n: {
differentDomains: process.env.NODE_ENV === 'production',
locales: [
{
code: 'uk',
domain: localeDomains.uk
},
{
code: 'fr',
domain: localeDomains.fr
}
]
}
})
使用上述配置,必须为暂存和生产运行不同的构建,使用不同的 .env 文件来指定 DOMAIN_UK
和 DOMAIN_FR
。
或者,为了避免需要多个构建,可以通过运行时环境变量覆盖语言环境域名。变量名称应遵循格式 NUXT_PUBLIC_I18N_LOCALES_{locale code}_DOMAIN
例如:
NUXT_PUBLIC_I18N_LOCALES_UK_DOMAIN=uk.example.test
NUXT_PUBLIC_I18N_LOCALES_FR_DOMAIN=fr.example.test
NUXT_PUBLIC_I18N_LOCALES_UK_DOMAIN=uk.staging.example.test
NUXT_PUBLIC_I18N_LOCALES_FR_DOMAIN=fr.staging.example.test
如果一个或多个域名需要承载多种语言,则每个域名的默认语言需要设置 domainDefault: true
,以便每个域名都有一个后备语言环境。
不过,选项 differentDomains
仍需设置为 true
。
export default defineNuxtConfig({
// ...
i18n: {
locales: [
{
code: 'en',
domain: 'mydomain.com',
domainDefault: true
},
{
code: 'pl',
domain: 'mydomain.com'
},
{
code: 'ua',
domain: 'mydomain.com'
},
{
code: 'es',
domain: 'es.mydomain.com',
domainDefault: true
},
{
code: 'fr',
domain: 'fr.mydomain.com',
domainDefault: true
}
],
strategy: 'prefix',
differentDomains: true
// 或仅在生产环境中启用该选项
// differentDomains: (process.env.NODE_ENV === 'production')
},
// ...
})
根据上述配置,使用 prefix
策略,以下请求将会是:
使用 prefix_except_default
策略时,相同请求将会是: