💡 Hilfe & Häufige Fragen

Die moderne Methode: Statt manueller .htaccess-Bearbeitung kannst du Redirects direkt im TYPO3-System verwalten. Dies bietet mehr Flexibilität und Übersichtlichkeit.

Schritt 1: Extension installieren

Installiere die Extension georgringer/redirect-generator via Composer:

• TYPO3 13 (LTS):

  ddev composer req georgringer/redirect-generator:@dev

  oder ohne DDEV:

  composer require georgringer/redirect-generator:@dev

• TYPO3 12 (LTS):

  ddev composer req georgringer/redirect-generator

  oder ohne DDEV:

  composer require georgringer/redirect-generator

Schritt 2: CSV-Datei generieren

1. Öffne den CSV zu Redirects Generator
2. Wähle das Format "TYPO3 CSV (Redirects Modul)"
3. Gib deine Ziel-Domain ein (z.B. https://www.example.com)
4. Lade deine CSV-Datei mit den URL-Paaren hoch
5. Lade die generierte .csv-Datei herunter

Schritt 3: CSV in TYPO3 importieren

Importiere die CSV-Datei via CLI (im TYPO3-Root-Verzeichnis):

typo3 redirect:import /pfad/zur/datei.csv

Nützliche Import-Optionen:

• --dry-run - Test-Durchlauf ohne tatsächlichen Import (empfohlen für erste Tests)
• --delete-file - Löscht die CSV-Datei nach erfolgreichem Import
• --external-domains - Liste externer Domains (Komma-getrennt)

Beispiel mit Test-Durchlauf:

typo3 redirect:import /var/www/html/uploads/redirects.csv --dry-run

Schritt 4: Redirects verwalten

Nach dem Import findest du die Redirects im TYPO3 Backend unter:

Site Management → Redirects

Hier kannst du:

• Alle importierten Redirects einsehen
• Einzelne Redirects bearbeiten oder löschen
• Statistiken über Redirect-Aufrufe ansehen (Zähler)
• Neue Redirects manuell hinzufügen

Tipp: Nutze --dry-run immer beim ersten Import, um zu prüfen, ob alle Redirects korrekt erkannt werden!

Wichtig: Die Redirect-Regeln müssen direkt nach der Zeile RewriteEngine On eingefügt werden, NICHT am Ende der Datei!

Warum? Apache arbeitet die RewriteRules von oben nach unten ab. Die erste passende Regel wird ausgeführt (wegen des L-Flags). Wenn deine Redirects am Ende stehen, greifen möglicherweise vorher schon andere TYPO3-Regeln und deine Redirects werden nie erreicht.

Speicherort der .htaccess:

• Standard-Installation (TYPO3 ≥ v9): public/.htaccess
• Deployment-Projekte (z.B. Deployer): shared/public/.htaccess
• Alte TYPO3-Versionen (< v9): .htaccess (im Root-Verzeichnis)

Beispiel für die richtige Platzierung:

RewriteEngine On

# 👉 HIER deine generierten Redirects einfügen (direkt nach RewriteEngine On)
RewriteRule ^de/alte-seite$ /neue-seite [R=301,L,NE]
RewriteRule ^de/produkt$ /shop/produkt [R=301,L,NE]
RewriteCond %{QUERY_STRING} ^id=123$
RewriteRule ^de/$ /neue-startseite?id=456 [R=301,L,NE]

# Danach folgen die Standard TYPO3 Regeln
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)\.(\d+)\.(php|js|css|png|jpg|gif|gzip)$ $1.$3 [L]
...

Tipp: Erstelle ein Backup der .htaccess-Datei, bevor du Änderungen vornimmst!

Beide Methoden haben ihre Vor- und Nachteile. Wähle die Methode, die am besten zu deinem Projekt passt:

✅ TYPO3 CSV-Import (empfohlen)

• Vorteile:
  • Zentrale Verwaltung im TYPO3 Backend
  • Statistiken über Redirect-Aufrufe (Zähler)
  • Einfache Bearbeitung und Löschung einzelner Redirects
  • Keine manuelle .htaccess-Bearbeitung nötig
  • Automatische Validierung durch TYPO3
  • Versionierung über TYPO3-Mechanismen möglich
  • Keine Apache-Neustarts bei Änderungen
• Nachteile:
  • Zusätzliche Extension erforderlich (georgringer/redirect-generator)
  • CLI-Zugriff für Import notwendig
• Ideal für: Projekte mit häufigen Redirect-Änderungen, mehreren Redakteuren, oder wenn Statistiken wichtig sind

📄 .htaccess-Methode

• Vorteile:
  • Keine zusätzliche Extension nötig
  • Performant bei wenigen Redirects (<50)
  • Funktioniert ohne TYPO3 Backend-Zugriff
  • Volle Kontrolle über RewriteRules
  • Versionierung über Git möglich
• Nachteile:
  • Manuelle .htaccess-Bearbeitung erforderlich
  • Keine Statistiken über Redirect-Nutzung
  • Keine GUI für Verwaltung
  • Fehlerhafte Syntax kann gesamte Website lahmlegen
  • Schwieriger zu warten bei vielen Redirects
  • Performance-Problem bei vielen Regeln: .htaccess wird bei jedem Request geparst (auch für CSS, JS, Bilder), was bei hunderten Redirects ineffizient wird
• Ideal für: Einfache Projekte mit wenigen Redirects (<50), einmalige Migrationen, oder wenn keine Extensions installiert werden können

💡 Empfehlung:

Für die meisten TYPO3-Projekte ist die CSV-Import-Methode die bessere Wahl. Sie bietet mehr Flexibilität, ist langfristig wartungsfreundlicher und bei vielen Redirects (>100) auch performanter, da die .htaccess bei jedem Request (inkl. statischer Dateien) geparst werden muss. Die .htaccess-Methode eignet sich vor allem für kleine Projekte mit wenigen Redirects (<50), einmalige Migrationen oder wenn keine Extensions installiert werden können.

Kann ich beide Methoden kombinieren?

Ja, das ist möglich! Du kannst z.B. wenige, statische Redirects in der .htaccess pflegen und dynamische oder häufig wechselnde Redirects über das TYPO3 Backend verwalten. Achte nur darauf, dass keine Konflikte entstehen (gleiche Source-URLs mit unterschiedlichen Zielen).