TYPO3 14.2: Fluid-Templates automatisch auf Fehler prüfen mit fluid:analyse

Mit TYPO3 14 kommt ein neuer CLI-Befehl, der dir das Leben bei der Migration deutlich erleichtert: fluid:analyse prüft deine Fluid-Templates automatisch auf Syntaxfehler und Deprecations.

Das Problem: Versteckte Fehler in Templates

Wer schon einmal ein größeres Projekt auf eine neue TYPO3-Version migriert hat, kennt das: Fluid-Templates, die jahrelang funktioniert haben, werfen plötzlich Fehler. Vielleicht sogar erst Wochen nach dem Go-Live, wenn ein Redakteur ein selten genutztes Template aufruft.

Mit Fluid 5 in TYPO3 14 gibt es einige Breaking Changes, die genau solche versteckten Probleme verursachen können. Das manuelle Durchsuchen aller Templates ist mühsam und fehleranfällig.

Die Lösung: Ein Befehl für alle Templates

Der neue Befehl fluid:analyse durchsucht automatisch alle Fluid-Templates in deinem Projekt und meldet:

• Syntaxfehler (ungültige Tag-Verschachtelung, fehlende Attribute)
• Ungültige ViewHelper oder Namespaces
• Verbotene Variablennamen (mit führendem Unterstrich)
• Deprecations von ViewHelpern oder Argumenten

vendor/bin/typo3 fluid:analyse

Die Ausgabe zeigt dir direkt, wo das Problem liegt:

[DEPRECATION] packages/myext/Resources/Private/Templates/Test.fluid.html: <my:obsolete> has been deprecated in X and will be removed in Y.
[ERROR] packages/myext/Resources/Private/Templates/Test2.fluid.html: Variable identifiers cannot start with a "_": _temp

Perfekt für CI/CD-Pipelines

Der Befehl ist bewusst CI-freundlich gestaltet:

• Exit-Code 1 nur bei echten Fehlern
• Exit-Code 0 bei Deprecations (Warnungen, aber kein harter Fehler)

So kannst du den Check in deine Pipeline einbauen, ohne dass Deprecations aus Third-Party-Extensions deinen Build blockieren.

Was wird geprüft?

Der Befehl findet automatisch alle Templates mit der neuen Dateiendung *.fluid.*. Wenn du also bereits auf die neue Fluid-Dateiendung umgestellt hast, profitierst du sofort.

Besonders wertvoll ist die Prüfung auf Variablennamen mit führendem Unterstrich. Diese sind in Fluid 5 nicht mehr erlaubt, weil sie für interne Zwecke reserviert sind. Ein häufiger Stolperstein bei der Migration, den der Befehl zuverlässig aufdeckt.

Zusammenhang mit anderen Fluid 5 Änderungen

Der fluid:analyse Befehl ist das zentrale Werkzeug, um die Breaking Changes aus Fluid 5 in deinem Projekt zu finden. In meinem Artikel zu den Fluid 5 Breaking Changes habe ich die wichtigsten Änderungen bereits zusammengefasst. Mit fluid:analyse kannst du jetzt automatisiert prüfen, ob dein Projekt betroffen ist.

Quelle: Changelog “Feature: #108763 - Console command to analyse Fluid templates”

Fazit

Der neue fluid:analyse Befehl ist ein kleines, aber feines Werkzeug für die Migration auf TYPO3 14. Er spart Zeit, findet versteckte Probleme und lässt sich nahtlos in CI/CD-Workflows integrieren.

Übrigens: Ich arbeite gerade am TYPO3 Komplettkurs mit einem flexiblen Zugangsmodell, der bei jeder neuen TYPO3-Version aktualisiert wird. Wenn du als Erster erfahren willst, wann es losgeht, und dir den vergünstigten Einführungspreis sichern willst, trag dich in die Warteliste ein.