intlayerProxy

intlayerProxy ist ein Vite-Plugin, das eine Sprach-Routing-Middleware für jede Umgebung registriert: Entwicklungs-Server, Vorschau-Server und Produktions-SSR (Nitro / TanStack Start).

Seit Intlayer v9 ist intlayerProxy automatisch im Hauptplugin intlayer() enthalten und standardmäßig über routing.enableProxy: true aktiviert. Sie müssen es nur separat registrieren, wenn Sie eine Kontrolle auf niedrigerer Ebene benötigen oder es außerhalb des Standard-Setups von intlayer() verwenden.

Verwendung

Als Teil von intlayer() (empfohlen, v9+)

Übergeben Sie proxy-Optionen an das Hauptplugin, anstatt intlayerProxy separat zu registrieren:

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

Standalone (falls erforderlich)

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

Optionen

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

Alle Optionen sind optional und werden als einzelnes Objekt übergeben:

Beispiel

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

createIntlayerProxyHandler

createIntlayerProxyHandler erstellt eine eigenständige, Framework-agnostische Node.js-Middleware (req, res, next), die die gesamte Sprach-Routing-Logik enthält. Sie ist nützlich in Umgebungen, in denen die Vite-Plugin-API nicht verfügbar ist (z. B. ein reiner Node.js-Server oder ein benutzerdefiniertes Nitro-Modul).

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

Produktions-SSR (TanStack Start / Nitro über h3)

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

Routing-Verhalten

Die Middleware spiegelt die Routing-Logik der next-intlayer-Middleware wider und unterstützt alle Intlayer-Routing-Modi.

Routing-Modi

Erkennungspriorität

1. URL-Pfadpräfix (z. B. /de/about → de).
2. Cookie- / localStorage-Wert (intlayer-locale).
3. Accept-Language-Header.
4. defaultLocale aus der Konfiguration.

Automatischer Bypass

Die Middleware leitet diese Anfragen immer direkt und ohne Sprachbehandlung weiter:

• Anfragen, die dem ignore-Prädikat entsprechen.
• /node_modules/**
• /@** – Vite-Interna (@vite/, @fs/, @id/ usw.).
• /_** – Server-Interna (__vite_ping, __manifest usw.).
• Anfragen, deren Pfad mit einer Dateiendung endet (statische Assets). Wenn ein Sprachpräfix im Pfad eines statischen Assets vorhanden ist (z. B. /de/logo.png), wird es entfernt, damit die Datei korrekt ausgeliefert werden kann.

Domain-Routing

Wenn routing.domains in Ihrer Intlayer-Konfiguration konfiguriert ist, verarbeitet die Middleware das domänenübergreifende Sprach-Routing:

• Eine Anfrage für /zh/about auf intlayer.org wird an https://intlayer.zh/about weitergeleitet, wenn domains.zh = "intlayer.zh".
• Eine Anfrage an intlayer.zh/about wird intern in /zh/about umgeschrieben, sodass der Routing-Parameter [locale] befüllt wird.

Schutz vor Redirect-Schleifen

Die Middleware verfolgt die Anzahl der Weiterleitungen pro originalUrl → newUrl-Paar innerhalb eines gleitenden 2-Sekunden-Fensters. Mehr als 10 Weiterleitungen innerhalb dieses Fensters geben eine 500-Antwort mit einem beschreibenden Fehler zurück, anstatt ewig im Kreis zu leiten.

Nitro / Produktions-SSR (automatische Injektion, v9+)

Wenn intlayerProxy als Vite-Plugin verwendet wird, trägt es eine .nitro-Eigenschaft. Das Build-Plugin nitro/vite liest diese Eigenschaft und fügt sie in nitroConfig.modules ein, sodass intlayerNitroHandler automatisch als Nitro-Server-Middleware registriert wird — für das Produktions-SSR ist keine manuelle Konfiguration erforderlich.

Der Nitro-Handler verwendet das Web Fetch API-Ereignismodell von h3 v2 (nicht fromNodeMiddleware), sodass er mit allen Nitro-Presets kompatibel ist: Node, Bun, Deno, Edge-Laufzeiten.

Veraltete Aliase