TYPO3-Testsystem springt auf die Live-Domain: Base-Varianten
Kurz gesagt: Wenn Ihre TYPO3-Testumgebung beim Klicken plötzlich auf die echte Website wechselt, Links im Menü auf die Live-Domain zeigen oder Redakteure versehentlich im falschen System arbeiten, fehlt meist eine saubere Trennung der Basisadressen. TYPO3 löst das mit „Base-Varianten“ in der Site-Konfiguration. Laut TYPO3-Dokumentation besteht jede Variante aus einer Basisadresse und einer Bedingung, die festlegt, wann sie gilt, zum Beispiel abhängig vom Application Context wie „Development“. Base-Varianten gibt es auch für einzelne Sprachen. Sie werden derzeit nur in der YAML-Datei der Site gepflegt, eine Oberfläche im Backend gibt es dafür laut Dokumentation noch nicht.
Das typische Bild in der Praxis
Viele Betriebe haben neben der Live-Website eine Kopie zum Testen, sei es bei der Agentur, auf einer Subdomain wie „test.“ oder „staging.“ oder lokal auf dem Rechner der Entwicklerin. Wird die Datenbank von Live auf Test kopiert, kommt die Site-Konfiguration mit, und darin steht die Live-Adresse als Basis. Die Folgen:
- Links im Menü der Testseite führen auf die Live-Domain. Wer klickt, landet unbemerkt im echten System.
- Redakteurinnen glauben, auf Test zu arbeiten, ändern aber Live-Inhalte.
- Vorschauen aus dem Backend öffnen die falsche Adresse.
- Formulare auf der Testseite schicken echte Mails an echte Kundschaft, weil niemand merkt, dass man auf Live ist.
Das Problem ist kein Fehler von TYPO3, sondern eine fehlende Unterscheidung zwischen den Umgebungen.
Wie Base-Varianten funktionieren
Seit es das Site Handling gibt, legt jede Site in TYPO3 ihre Basisadresse in einer Konfigurationsdatei fest, typischerweise unter config/sites/<site>/config.yaml. Laut Dokumentation sind für die Domainzuordnung keine sys_domain-Datensätze mehr nötig, wie es in älteren Versionen der Fall war.
Neben der Hauptadresse unter „base“ können Sie unter „baseVariants“ weitere Adressen eintragen. Jede Variante hat zwei Teile:
- base: die Adresse, die in diesem Fall gelten soll, etwa https://staging.ihre-domain.at/ oder https://projekt.localhost/.
- condition: eine Bedingung, die bestimmt, wann die Variante aktiv ist.
Die Bedingungen nutzen laut Dokumentation die Symfony Expression Language. Ein Beispiel aus der Dokumentation ist applicationContext == "Development". Die Dokumentation zeigt auch, wie Umgebungsvariablen genutzt werden: In der Basisadresse über %env(...)%, in der Bedingung über getenv(...).
Ein vereinfachtes Beispiel für eine Site mit Live-, Test- und lokaler Adresse:
base: 'https://www.beispiel-betrieb.at/'
baseVariants:
- base: 'https://beispiel-betrieb.localhost/'
condition: 'applicationContext == "Development"'
- base: 'https://staging.beispiel-betrieb.at/'
condition: 'applicationContext == "Production/Staging"'
Der Application Context
Damit die Bedingung greift, muss jede Umgebung wissen, wer sie ist. Dafür setzt TYPO3 den Application Context, meist über die Umgebungsvariable TYPO3_CONTEXT in der Serverkonfiguration oder in der Datei, die Ihre Hosting-Plattform für Umgebungsvariablen vorsieht. Typische Werte sind „Production“, „Development“ oder Unterkontexte wie „Production/Staging“. Die genaue Einrichtung hängt vom Hosting ab und gehört in die Hände der Person, die Ihren Server betreut.
Der Vorteil: Dieselbe Konfigurationsdatei kann auf allen Systemen liegen. Jede Umgebung wählt anhand ihres Kontexts die richtige Adresse. Wer die Datenbank oder die Dateien von Live auf Test kopiert, nimmt die richtige Logik gleich mit.
Mehrsprachige Websites
Viele Websites in Österreich haben neben Deutsch eine englische oder eine weitere Sprachfassung, manchmal unter eigener Domain. Laut Dokumentation gibt es Base-Varianten auch für Sprachen. Prüfen Sie deshalb nicht nur die Hauptadresse, sondern auch jede Sprache, die eine eigene absolute Adresse hat. Sonst funktioniert die deutsche Testseite, während der Wechsel auf Englisch wieder auf die Live-Domain führt.
Schritt für Schritt einführen
- Bestandsaufnahme: Welche Umgebungen gibt es? Live, Test, lokal, eventuell eine Abnahmeumgebung für Kundinnen.
- Adressen festlegen: Für jede Umgebung eine eindeutige Basisadresse, die man auf den ersten Blick erkennt.
- Kontext setzen: Auf jedem Server den passenden Application Context einrichten lassen.
- Varianten eintragen: In der YAML-Datei der Site die Varianten mit Bedingungen ergänzen, auch für Sprachen mit eigener Adresse.
- Testen: Auf der Testumgebung das Menü durchklicken, Vorschau aus dem Backend öffnen, Sprache wechseln. Jeder Link muss auf der Testdomain bleiben.
- Absichern: Testumgebung zusätzlich mit Passwortschutz versehen und den Mailversand dort so einstellen, dass keine echten Kundinnen Nachrichten bekommen.
Häufige Stolpersteine bei der Einrichtung
Schreibweise des Kontexts. Die Bedingung vergleicht Text genau. Steht auf dem Server „production/staging“ in Kleinbuchstaben, in der Bedingung aber „Production/Staging“, greift die Variante nicht. Halten Sie die Schreibweise an einer Stelle fest, etwa in der Projektdokumentation, und übernehmen Sie sie wörtlich.
Reihenfolge und Überschneidungen. Wenn zwei Bedingungen gleichzeitig zutreffen könnten, ist schwer vorherzusagen, welche Adresse am Ende gilt. Formulieren Sie die Bedingungen so, dass für jede Umgebung genau eine zutrifft.
Zwischenspeicher. Nach Änderungen an der Site-Konfiguration zeigt TYPO3 manchmal noch alte Links, bis die Caches geleert sind. Leeren Sie nach jeder Änderung die Caches, bevor Sie testen, sonst suchen Sie einen Fehler, der längst behoben ist.
Absolute Links im Inhalt. Base-Varianten wirken auf Links, die TYPO3 selbst erzeugt. Hat eine Redakteurin eine Live-Adresse von Hand in einen Text kopiert, bleibt dieser Link auf jedem System gleich. Bitten Sie das Team, für interne Verweise immer die Seitenauswahl des Backends zu nutzen statt kopierter Adressen.
Proxy und Weiterleitungen. Steht vor dem Testserver ein Proxy oder eine Weiterleitung, die selbst auf die Live-Domain umleitet, hilft keine Variante. Prüfen Sie im Zweifel zuerst, welche Adresse der Browser tatsächlich aufruft.
Zusätzliche Sicherheitsnetze
Base-Varianten lösen das Adressproblem. Ein paar weitere Punkte sorgen dafür, dass Test und Live nicht verwechselt werden:
- Farbliche Kennzeichnung im Backend, etwa ein deutlich anderer Hinweis oder Seitenname auf dem Testsystem, damit Redakteure sofort sehen, wo sie arbeiten.
- Getrennte Zugänge, damit nicht jede Person automatisch auf beiden Systemen Rechte hat.
- Klare Regel für Datenbank-Kopien: Wann wird Live nach Test kopiert, und wer prüft danach die Adressen?
Ein Beispiel
Eine Tourismusregion in Tirol pflegt ihre Website mit TYPO3 und lässt Erweiterungen auf einer Testumgebung abnehmen (Beispiel zur Veranschaulichung). Nach jeder Datenbank-Kopie zeigt das Menü der Testseite auf die Live-Domain, und zweimal wurden versehentlich Live-Inhalte geändert. Die Agentur trägt Base-Varianten für Test und lokale Entwicklung ein, setzt den Application Context auf jedem Server und ergänzt eine Variante für die englische Sprachfassung. Seither bleibt jeder Klick auf der jeweiligen Umgebung.
Häufige Fragen
Kann ich Base-Varianten im Backend einstellen?
Laut TYPO3-Dokumentation derzeit nicht. Sie werden in der YAML-Datei der Site gepflegt.
Brauche ich noch Domain-Datensätze wie früher?
Laut Dokumentation nicht. Mit dem Site Handling sind sys_domain-Datensätze für diesen Zweck nicht mehr nötig.
Was passiert, wenn keine Bedingung zutrifft?
Dann gilt die Hauptadresse unter „base“. Deshalb sollte dort die Live-Adresse stehen.
Hilft das auch gegen versehentliche Mails aus dem Testsystem?
Nicht direkt. Dafür stellen Sie den Mailversand auf der Testumgebung gesondert ein.
Wenn Ihre TYPO3-Umgebungen sauber getrennt werden sollen, damit Tests nie wieder Live-Inhalte berühren, sprechen Sie mit uns.