Achtung beim direkten Update von Contao 4.13 auf 5.7

Moin!

Als regelmäßige:r Leser:in der Flaschenpost weißt du: Contao 4.13 ist am Ende!

Mit der neuen Contao 5.7 LTS ist die Versuchung groß, direkt von Contao 4.13 (oder noch älter) auf Contao 5.7 zu aktualisieren.

Ich weiß, wovon ich spreche, denn ich mache auch gerade ein Update von Contao 4.13 auf 5.7 und möchte dir in der heutigen Flaschenpost meine bisherigen Erkenntnisse mitteilen.

Warum 4.13 → 5.7 oft schiefgeht

• Erweiterungen sind die größte Baustelle
  „Contao 5 kompatibel“ heißt oft: getestet mit 5.3. Nicht automatisch mit 5.7. Gerade bei neueren Minor-Versionen kommen Änderungen dazu, die Erweiterungen nicht direkt mitmachen (Turbo, Twig etc.).
• Deprecated Code fliegt raus
  Dinge, die in 5.3 noch funktionieren (mit Warnung), sind in 5.7 teilweise einfach weg. Wenn eine Erweiterung oder dein eigenes Projekt darauf basiert: Feierabend.
• Symfony- und PHP-Sprünge
  Im Motorraum passiert einiges. Neue Symfony-Versionen, neue PHP-Anforderungen – das kann dir indirekt alles zerschießen, was vorher noch lief.
• Templates und Hooks
  Gerade bei individuellen Anpassungen knallt es hier gern. Was vorher „ging“, ist plötzlich nicht mehr vorgesehen.

Warum 4.13 → 5.3 deutlich entspannter ist

• 5.3 ist für viele Entwickler:innen immer noch die Version, auf die sich die meisten Erweiterungen konzentrieren
• Viele Entwickler:innen testen genau diesen Sprung von 4.13 auf 5.3, aber nicht unbedingt von 5.3 auf 5.7
• Wenn bei einer Erweiterung steht „Contao 5 kompatibel“, bedeutet das oft nur: läuft unter 5.3. Sie muss aber nicht unter Contao 5.7 laufen.
• Deprecated-Kram ist oft noch vorhanden (mit Warnung statt Fehler)
• du bekommst eine stabile Zwischenstufe, auf der du sauber aufräumen kannst

Heißt konkret: Der saubere Weg ist 4.13 → 5.3 (auch wenn 5.3 nur noch bis 2028 Updates bekommt).

Alles andere ist oft Glücksspiel. Es kann funktionieren – muss aber nicht.

Ich prüfe aktuell bei Updates immer sehr genau, welche Erweiterungen wirklich bis zur Zielversion getestet sind. Das ist mit ner Menge Handarbeit und Prüfen von Github-Tickets verbunden. Aber es lohnt sich, die Arbeit vorher zu machen, anstatt bei der Umsetzung festzustellen, dass das was angeboten wurde, gar nicht gehalten werden kann.

Wenn du gerade vor so einem Update stehst und dir unsicher bist: Mach lieber den kleinen Sprung auf 5.3 als den großen auf 5.7!

Erstma',
Dennis

PS: Kein Bock auf Updates? Wir helfen dir.