RealURL-Fehler: Reason: Segment “” was not a keyword for a postVarSet as expected!

Bei der Neuinstallation der Typo3-Extension RealURL läuft in den seltensten Fällen alles glatt. Oft sind es Kleinigkeiten oder nicht nachvollziehbare Fehlermeldungen. Viele Fehlermeldungen sind selbsterklärend und reproduzierbar. In manchen Fällen auch diese Fehlermeldung:

Segment “” was not a keyword for a postVarSet as expected!

Diese Fehlermeldung kann an simplen Fehlern liegen und entweder bei allen Seiten erscheinen, unregelmäßig auftauchen oder nur im Browser auftreten mit dem man auch im Backend eingeloggt ist.

Hier eine Checkliste um den Fehler zu beseitigen:

1. Root-Page in der Real-URL Konfiguration setzen:

$TYPO3_CONF_VARS['EXTCONF']['realurl'] = array(
...
'rootpage_id' => 7,
'firstHitPathCache' => 1,
...
); Die Konfigurationsdatei kann entweder in “/typoconf/realurlconf.php” oder direkt in der “/typoconf/localconf.php” editiert werden. Alternativ erleichtert die Extension: “danp_realurlconfigurator” die Arbeit, da dadurch die Konfigurationsdatei direkt im Backend editierbar wird. Im diesem Zuge kann neben der korrekten Seiten-ID des Seitenausgangspunktes auch die Einstellung “FirstHitPathCache” ausprobiert werden.

2. Haken setzen bei “Ist Start der Website”:

Um RealURL über Flexform zu informieren welche Seite die Startseite ist, muss ein Haken gesetzt werden unter: Web > Seite > “Startseite im Seitenbaum” > Seiteneigenschaften > Optionen > (ggf. Zweite Optionspalette anzeigen) > Ist Anfang der Website. Zudem kann es sein, dass ein weiteres eingebundenes Template einen “Ist Anfang der Website” zuviel hat.

3. Real URL ID-to-path mapping leeren:

Um ggf. falsche Caches zu leeren, sollte nicht nur der Typo3-Cache geleert werden, sondern auch das RealURL Mapping. Dieser Schritt ist hilfreich wenn der Fehler nur teilweise auftaucht. Dann ist es sinnvoll wenn “/seite/unterseite” nicht funktioniert auch die gespeicherten Informationen bzgl. “/seite/” zu löschen.
Die Option ist zu finden unter: Web > Info > RealURL-Verwaltung > ID-to-path mapping > Löschen

4. Datenbanktabellen leeren:

Erst wenn der Punkt 3 ausprobiert wurde, sollte der Datenbankinhalt der RealURL Tabellen geleert werden. Die Datenbank darf jedoch nicht gelöscht werden. Hilfreich ist hierbei die Extension “phpmyadmin“. So können Sie die Tabellen die mit “tx_realurl_*” beginnen einfach leeren.

5. Admin Panel deaktivieren:

Wenn das Problem im Zusammenhang mit dem genutzten Browser steht, also das Problem nur in dem Browser vorkommt, in dem man auch eingeloggt ist, sollte es helfen das Admin-Panel zu deaktivieren.
Das Admin-Panel wird per TypoScript aktiviert und kann so auch deaktiviert werden:
Template > “Templatedatei im Seitenbaum wählen” >Setup >”config.admPanel = 0″.
Den Fehler konnte ich so nie nachvollziehen. Ggf. ist das Deaktivieren des Browsercaches durch den WebDeveloper nützlich, um dieses Verhalten direkt auszuschließen. Auch das Besuchen der neuen Unterseite mit einem anderen Browser (ggf. auch erstmalig) kann hierbei helfen.

6. Konfigurationsdatei:

Wer garnicht weiterkommt kann, wirklich nur als Verzweiflungstat, versuchen im Web umhergestreute Konfigurationsdateien von RealURL auszuprobieren und das Verhalten zu reproduzieren. Dabei sollte ein Backup der alten Konfigurationsdatei gemacht werden (über den Zwischenspeicher hinaus). Wer noch Zeit mitbringt, sollte die ausführliche Dokumentation der Extension im Typo3 Repository durcharbeiten, um den Fehler Konfigurationsdatei ausschließen zu können und gleichzeitig umfassendes Wissen anzuhäufen.
Abschließend würde ich mich freuen zu erfahren, ob es mehr Möglichkeiten oder Symptome dieses Fehlers gibt und wem welche Lösung geholfen hat.

6.1. RealURL “Hack”:

Laut Alex von einpraegsam.net kann der Fehler bei bestimmten Serverkonfigurationen beseitigt werden, indem man die Methode “decodeSpURL($params)” (Zeile 905) in der Datei “class.tx_realurl.php” mit folgenden Code erweitert: $this->pObj->siteScript = substr($_SERVER['SCRIPT_URL'], 1); Danke Alex.

7. Sichtbarkeit im Menu:

Es kann auch vorkommen, dass RealURL den URL-Namen nicht erfassen kann, da die neue Seite als “nicht im Menu anzeigen” markiert ist. Ein Umschalten und Aufrufen im Frontend löst das Problem, auch wenn die Seite daraufhin erneut als “nicht im Menu anzeigen” markiert wird.

8. tt_news Datensatzstruktur:

Scheinbar kann es in Verbindung mit der beliebten News-Extension tt_news dazu kommen, dass RealURL sich verschluckt wenn Sysordner (Datensatz “Aufbewahrer”) und die Contentseite mit der Listenansicht auf der gleichenHierarchieebene liegen und gleich benannt sind. Ich könnte mir sehr gut vorstellen, dass der Sysordner sich auch mit der Latest und Singleansicht beißt. Danke an lentizz.