intlayerProxy

intlayerProxy, her ortam için dil yönlendirme ara yazılımını (middleware) kaydeden bir Vite eklentisidir: geliştirme sunucusu (dev server), önizleme sunucusu (preview server) ve üretim SSR (Nitro / TanStack Start).

Intlayer v9'dan beri intlayerProxy, ana intlayer() eklentisine otomatik olarak dahil edilir ve routing.enableProxy: true aracılığıyla varsayılan olarak etkinleştirilir. Yalnızca daha düşük seviyeli kontrole ihtiyacınız olduğunda veya bunu standart intlayer() kurulumunun dışında kullandığınızda ayrıca kaydetmeniz gerekir.

Kullanım

intlayer() Eklentisinin Parçası Olarak (Önerilen, v9+)

intlayerProxy'yi ayrıca kaydetmek yerine ana eklentiye proxy seçeneklerini iletin:

// vite.config.tsimport { defineConfig } from "vite";import { intlayer } from "vite-intlayer";export default defineConfig({  plugins: [    intlayer({      proxy: {        ignore: (req) => req.url?.startsWith("/api"),      },    }),  ],});

Bağımsız (Standalone - gerektiğinde)

// vite.config.tsimport { defineConfig } from "vite";import { intlayer } from "vite-intlayer";export default defineConfig({  plugins: [intlayer()],});

Seçenekler

import type { IntlayerProxyPluginOptions } from "vite-intlayer";

Tüm seçenekler isteğe bağlıdır ve tek bir nesne olarak iletilir:

Örnek

intlayerProxy({  ignore: (req) => req.url?.startsWith("/api"),  configOptions: { configFile: "./config/intlayer.config.ts" },});

createIntlayerProxyHandler

createIntlayerProxyHandler, tüm dil yönlendirme mantığını içeren bağımsız, framework'ten bağımsız bir Node.js (req, res, next) ara yazılımı oluşturur. Vite eklenti API'sinin kullanılamadığı ortamlarda (örneğin düz bir Node.js sunucusu veya özel bir Nitro modülü) yararlıdır.

import { createIntlayerProxyHandler } from "vite-intlayer";const handler = createIntlayerProxyHandler({  ignore: (req) => req.url?.startsWith("/api"),  configOptions: { configFile: "./config/intlayer.config.ts" },});// Express / Connectapp.use(handler);

Üretim SSR (TanStack Start / h3 aracılığıyla Nitro)

// server/middleware/intlayerProxy.tsimport { fromNodeMiddleware } from "h3";import { createIntlayerProxyHandler } from "vite-intlayer";export default fromNodeMiddleware(  createIntlayerProxyHandler({    ignore: (req) => req.url?.startsWith("/api"),  }));

Yönlendirme Davranışı

Ara yazılım, next-intlayer ara yazılımının yönlendirme mantığını yansıtır ve tüm Intlayer yönlendirme modlarını destekler.

Yönlendirme Modları

Algılama Önceliği

1. URL yolu öneki (örneğin /tr/about → tr).
2. Çerez / localStorage değeri (intlayer-locale).
3. Accept-Language üstbilgisi (header).
4. Yapılandırmadaki defaultLocale.

Otomatik Atlatma (Bypass)

Ara yazılım, bu istekleri dil işlemi yapmadan her zaman doğrudan iletir:

• ignore yüklemiyle eşleşen istekler.
• /node_modules/**
• /@** – Vite dahili bileşenleri (@vite/, @fs/, @id/ vb.).
• /_** – sunucu dahili bileşenleri (__vite_ping, __manifest vb.).
• Yolu bir dosya uzantısıyla biten istekler (statische assets). Statik bir varlık yolunda bir dil öneki varsa (örneğin /tr/logo.png), dosyanın doğru şekilde sunulabilmesi için bu önek kaldırılır.

Alan Adı Yönlendirmesi (Domain Routing)

Intlayer yapılandırmanızda routing.domains yapılandırıldığında, ara yazılım alan adları arası dil yönlendirmesini yönetir:

• domains.zh = "intlayer.zh" olduğunda, intlayer.org üzerindeki /zh/about isteği https://intlayer.zh/about adresine yönlendirilir.
• intlayer.zh/about isteği, [locale] rota parametresinin doldurulması için dahili olarak /zh/about şeklinde yeniden yazılır.

Yönlendirme Döngüsü Koruması (Redirect Loop Protection)

Ara yazılım, 2 saniyelik kayan bir pencere içinde originalUrl → newUrl çifti başına yönlendirme sayılarını izler. Bu pencere içinde 10'dan fazla yönlendirme, sonsuza kadar döngüye girmek yerine açıklayıcı bir hata ile birlikte 500 yanıtı döndürür.

Nitro / Üretim SSR (Otomatik Enjeksiyon, v9+)

intlayerProxy bir Vite eklentisi olarak kullanıldığında, bir .nitro özelliği taşır. nitro/vite derleme eklentisi bu özelliği okur ve nitroConfig.modules içine ekler, böylece intlayerNitroHandler otomatik olarak bir Nitro sunucu ara yazılımı olarak kaydedilir — üretim SSR için manuel yapılandırma gerekmez.

Nitro işleyicisi (handler), h3 v2'nin Web Fetch API olay modelini kullanır (fromNodeMiddleware değil), bu nedenle tüm Nitro şablonlarıyla (Node, Bun, Deno, edge runtimes) uyumludur.

Kullanımdan Kaldırılan Takma Adlar (Deprecated)