Fractor 1.0: Warum ich es bei TYPO3-Upgrades nicht mehr missen will

Fractor 1.0 ist seit dem 9. Juli 2026 verfügbar. Ich nutze das Tool bei fast jedem TYPO3-Upgrade zusammen mit Rector, gerade bei alten Installationen zahlt sich das aus. Ein persönlicher Rückblick auf das Release und darauf, warum die Kombination beider Tools inzwischen fester Bestandteil meiner Upgrade-Arbeit ist.

Fractor 1.0 ist da

Am 9. Juli 2026 ist Fractor 1.0.0 erschienen. Simon Schaufelberger, der die Hauptentwicklung des Tools inzwischen übernommen hat, hat die Ankündigung im Entwickler-Slack geteilt, und ich habe sofort reingeschaut.

Fractor gibt es seit Mai 2024. Andreas Wolf und Sebastian Schreiber haben das Tool gestartet, um auch Nicht-PHP-Dateien migrierbar zu machen. Simon ist später eingestiegen, hat zunächst viele neue Regeln beigesteuert und dann die Entwicklung immer stärker mit Rector synchronisiert. Der eigentliche Grund, warum ich Fractor so intensiv nutze, ist aber ein anderer: Es nimmt mir bei der Migration von altem TypoScript, Fluid-ViewHelpern und Co. sehr viel Arbeit ab.

Was Fractor eigentlich macht

Rector kennst du wahrscheinlich schon: Es aktualisiert und modernisiert PHP-Code automatisch. Fractor macht im Prinzip dasselbe, nur für alle anderen Dateien, die bei einem TYPO3-Upgrade ebenfalls veralten. TypoScript, Fluid-Templates, YAML-Konfigurationen, XLIFF-Übersetzungsdateien und mehr.

Das Kernpaket a9f/fractor liefert nur die Infrastruktur zum Konfigurieren und Ausführen. Die eigentlichen Regeln kommen aus einzelnen Paketen je Dateityp. Als TYPO3-Nutzer installierst du in der Regel einfach a9f/typo3-fractor, das die relevanten Pakete für Fluid, TypoScript, YAML und mehr direkt mitbringt.

Warum ich es bei fast jedem Upgrade einsetze

Ich setze Fractor inzwischen bei praktisch jedem TYPO3-Upgrade ein, immer in Kombination mit Rector. Der Ablauf ist bei beiden Tools fast identisch: erst ein Testlauf, um zu sehen, was sich ändern würde, dann die vorgeschlagenen Änderungen prüfen, dann erst wirklich ausführen. Diese Konsistenz macht die tägliche Arbeit einfacher. Ich muss nicht zwischen zwei völlig unterschiedlichen Denkweisen wechseln, nur weil ich gerade eine TypoScript-Datei statt einer PHP-Klasse anfasse.

Was mir dabei besonders gefällt: Fractor läuft komplett unter meiner Kontrolle. Nichts passiert automatisch im Hintergrund. Ich sehe jede vorgeschlagene Änderung, bevor sie tatsächlich im Code landet, und kann einzelne Regeln, Dateien oder ganze Ordner gezielt ausschließen, wenn etwas nicht passt.

Der eigentliche Mehrwert liegt bei alten Versionen

Bei Upgrades von aktuellen oder recht neuen TYPO3-Versionen hält sich der Aufwand für TypoScript, Fluid und Co. oft in Grenzen. Richtig wertvoll wird Fractor bei Projekten, die aus sehr alten TYPO3-Versionen hochgezogen werden, wie ich sie in meiner Arbeit als Integrator und Trainer immer wieder sehe.

Über mehrere Hauptversionen hinweg sammelt sich einiges an veralteter Syntax an: TypoScript-Notationen, die nicht mehr empfohlen sind, Fluid-Konstrukte, die durch neue ViewHelper ersetzt wurden, XLIFF-Dateien mit veraltetem Format. Das manuell durchzugehen, kostet bei größeren Projekten schnell mehrere Stunden bis Tage. Fractor übernimmt einen guten Teil davon automatisiert und lässt mir Zeit für die Themen, die wirklich Nachdenken erfordern, etwa die Entscheidung, welche Extensions ersetzt werden müssen.

Was sich mit Version 1.0 ändert

Der Changelog zu 1.0.0 zeigt vor allem eines: Fractor rückt noch näher an Rector heran. Die CLI-Parameter sind jetzt größtenteils identisch, mit wenigen Einschränkungen. Simon selbst nennt --only, --rules-summary und --output-format als die wichtigsten davon.

Dazu kommen kleinere, aber praktische Neuerungen: eine --no-diffs-Option, eine --memory-limit-Option, und die alte --quiet-Option wurde zugunsten von --no-diffs entfernt. Ein neuer XLIFF-Datei-Prozessor, beigetragen von Christian Sonntag, erweitert die unterstützten Dateitypen um ein Format, das für mehrsprachige TYPO3-Websites wichtig ist.

Ein Wort des Dank an die Macher

Tools wie Fractor entstehen nicht von selbst. Andreas Wolf und Sebastian Schreiber haben die Grundlage gelegt. Simon Schaufelberger treibt die Weiterentwicklung seit einiger Zeit maßgeblich voran. Christian Sonntag hat mit dem XLIFF-Prozessor ein Stück beigetragen, das gerade für internationale TYPO3-Projekte relevant ist. Ohne diese Arbeit im Hintergrund wäre ein großer Teil meiner Upgrade-Projekte deutlich mühsamer.

Nebenbei: Simon hat bei der Ankündigung schon durchblicken lassen, dass er bei den TYPO3 Developer Days ein neues Tool vorstellt, das auf Rector und Fractor aufbaut. Ich bin gespannt, was da kommt.

Fazit

Fractor ist für mich längst kein Nischenwerkzeug mehr, sondern ein fester Bestandteil meiner Upgrade-Praxis, direkt neben Rector. Gerade wer Projekte aus alten TYPO3-Versionen übernimmt oder selbst hochzieht, sollte sich das Tool ansehen. Version 1.0 macht die Bedienung noch konsistenter mit Rector und damit den Einstieg noch leichter.