TYPO3 14.2: Fluid-Templates automatisch auf Fehler prüfen mit fluid:analyse
Artikel vorlesen lassen
Mit TYPO3 14.2 kommt ein neuer CLI-Befehl, der Fluid-Templates automatisch auf Fehler und Deprecations prüft. Perfekt für die Migration und CI/CD-Pipelines.
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 an etwas Neuem für alle, die TYPO3 von Grund auf lernen wollen. Mehr dazu bald.
ZurückKommentare unter Artikeln sind deaktiviert. Wenn du eine Frage oder Ergänzung hast, schreib mir bitte eine E-Mail.
Wer schreibt hier?
Hi, ich bin Wolfgang.
Seit 2006 tauche ich tief in die faszinierende Welt von TYPO3 ein – es ist nicht nur mein Beruf, sondern auch meine Leidenschaft. Mein Weg führte mich durch unzählige Projekte, und ich habe Hunderte von professionellen Videoanleitungen erstellt, die sich auf TYPO3 und seine Erweiterungen konzentrieren. Ich liebe es, komplexe Themen zu entwirren und in leicht verständliche Konzepte zu verwandeln, was sich auch in meinen Schulungen und Seminaren widerspiegelt.
Als aktives Mitglied im TYPO3 Education Committee setze ich mich dafür ein, dass die Prüfungsfragen für den TYPO3 CMS Certified Integrator stets aktuell und herausfordernd bleiben.
Meine Leidenschaft endet aber nicht am Bildschirm. Wenn ich nicht gerade in die Tiefen von TYPO3 eintauche, findest du mich oft auf meinem Rad, während ich die malerischen Wege am Bodensee erkunde. Diese Ausflüge ins Freie sind mein perfekter Ausgleich – sie halten meinen Geist frisch und liefern mir immer wieder neue Ideen.