Von Contao 4 auf 5 — was tatsächlich passiert.

Vorher klären.

1. Ausgangsversion genau feststellen, nicht schätzen.
2. PHP-Version des Servers und verfügbare Alternativen.
3. Erweiterungsliste mit Versionen und Herstellern.
4. Eigene Templates auflisten — wie viele, wie stark angepasst?
5. Eigener Code: Gibt es ein Projektpaket oder Anpassungen im Kern?
6. Angebundene Systeme notieren.
7. Zugänge klären: Kommandozeile vorhanden oder nur Dateizugriff?

Punkt sieben entscheidet über den Weg. Mit Kommandozeilenzugriff ist ein Contao-Update ein geordneter Vorgang. Ohne wird es umständlich — dann lohnt es, den Hoster zu fragen oder das Update in einer lokalen Umgebung vorzubereiten und das Ergebnis hochzuladen.

Punkt fünf ist wichtig für die Risikoeinschätzung: Anpassungen im Kern sind der klassische Grund, warum ein Update scheitert — sie werden beim Aktualisieren überschrieben, und was dann fehlt, merkt man erst im Betrieb.

Testumgebung.

Nicht verhandelbar. Ein Contao-Hauptversionssprung wird nie direkt am laufenden System gemacht — die Datenbankanpassung ist nicht umkehrbar, und ein Rückweg besteht dann nur über die Sicherung.

Üblich ist eine Kopie auf einer Subdomain oder lokal: Dateien und Datenbank klonen, Adressen anpassen, vor Suchmaschinen sperren. Dort läuft das Update, dort wird geprüft, und erst wenn alles sitzt, wird der Vorgang auf dem Live-System wiederholt oder die Kopie umgeschaltet (Testumgebung einrichten).

Schritt 1: PHP.

Contao 5 verlangt eine aktuelle PHP-Fassung. Hebe die Version zuerst an, solange noch Contao 4 läuft — dann siehst du getrennt, was an PHP liegt und was am Versionssprung.

Was dabei typischerweise bricht: alte Erweiterungen mit überholter Syntax, eigener Code mit nicht mehr erlaubten Konstrukten, Funktionen, die entfernt wurden. Die Fehlermeldungen sind dabei meist eindeutig und nennen Datei und Zeile.

Wenn der Hoster die Version nicht je Projekt umschalten lässt, ist das ein eigenes Thema — und manchmal der Anlass, über den Hoster nachzudenken (Hoster wechseln).

Schritt 2: Abhängigkeiten.

Contao verwaltet seine Bestandteile über eine Abhängigkeitsverwaltung. Beim Hauptversionssprung wird die Anforderung in der Projektdatei angehoben und die Auflösung angestoßen.

Hier entstehen die meisten Abbrüche, und sie haben fast immer dieselbe Form: Eine Erweiterung verlangt eine Fassung, die mit der neuen Hauptversion unvereinbar ist. Die Meldung nennt die beteiligten Pakete — sie zu lesen lohnt sich, auch wenn sie unübersichtlich wirkt.

Vorgehen bei einem Konflikt: Prüfen, ob es eine neuere Fassung der Erweiterung gibt. Wenn nein, ob die Erweiterung noch gebraucht wird. Wenn ja, ob es einen Ersatz gibt. Erst danach über eine eigene Anpassung nachdenken.

Zwei praktische Hinweise: Der Vorgang braucht Arbeitsspeicher — auf knapp bemessenen Servern scheitert er daran und nicht an den Paketen. Und die erzeugte Sperrdatei gehört in die Versionsverwaltung, damit auf allen Umgebungen dasselbe läuft.

Schritt 3: Datenbank.

Nach dem Aktualisieren der Dateien wird die Datenbankstruktur angeglichen. Contao bietet dafür einen Abgleich, der die nötigen Änderungen vorschlägt.

Wichtig: Die vorgeschlagenen Befehle vorher lesen. Der Abgleich schlägt auch das Löschen von Tabellen und Spalten vor, die er nicht zuordnen kann — und das sind manchmal Daten einer Erweiterung, die gerade nicht installiert ist. Werden diese Löschungen bestätigt, sind die Daten weg.

Also: Sicherung vorher, Vorschläge durchsehen, im Zweifel Löschungen nicht ausführen und erst klären, wozu die Tabelle gehört.

Schritt 4: Templates.

Die größte Nacharbeit bei stark angepassten Installationen. Contao 5 setzt verstärkt auf eine moderne Templating-Schicht; die alte Form wird weiterhin unterstützt, aber das Umfeld hat sich verändert.

Praktisch heißt das: Eigene Templates, die von Kerntemplates abgeleitet wurden, können veraltete Strukturen enthalten. Sie funktionieren teils noch, geben aber nicht mehr dasselbe aus — und dann fehlen Elemente oder die Gestaltung verrutscht.

Vorgehen: Alle eigenen Templates auflisten, mit der neuen Kernfassung vergleichen, Anpassungen gezielt übertragen statt die alte Datei weiterzuschleppen. Das ist Fleißarbeit, aber überschaubar — und ein guter Zeitpunkt, Templates wegzulassen, die nur eine Kleinigkeit ändern.

Schritt 5: Eigener Code.

Anpassungen im Kern sind der klassische Problemfall. Sie werden beim Update überschrieben, und was sie bewirkt haben, fehlt danach. Deshalb gilt: Vor dem Update die Kerndateien mit dem Original vergleichen und jede Abweichung dokumentieren.

Sauber umgesetzte Anpassungen liegen in einem eigenen Projektpaket und bleiben erhalten — müssen aber auf geänderte Schnittstellen geprüft werden. Zwischen Hauptversionen werden veraltete Funktionen entfernt, und was in Contao 4 nur eine Warnung erzeugte, ist in 5 ein Fehler.

Wenn es ein Projektpaket gibt, prüf auch die Konfigurationsdateien: Deren Format und Ablageort haben sich im Zuge der Entwicklung verändert.

Typische Fehlermeldungen.

Bei Zeile drei gilt derselbe Weg wie immer: Fehlerprotokoll ansehen, statt zu raten. Die Meldung steht dort im Klartext mit Datei und Zeile (Weiße Seite).

Durchprüfen.

1. Jeden Seitentyp aufrufen, nicht nur die Startseite.
2. Alle Inhaltselemente, die tatsächlich verwendet werden.
3. Formulare absenden und prüfen, ob die Mail ankommt.
4. Geschützte Bereiche mit einem Testzugang.
5. Suche ausprobieren.
6. Backend: Anlegen, Bearbeiten, Dateiverwaltung, Rechte.
7. Mehrsprachigkeit, falls vorhanden.
8. Mobil gegenprüfen.

Umschalten.

Zwei Wege. Entweder die geprüfte Testumgebung wird zur Live-Fassung — dann müssen zwischenzeitlich entstandene Inhalte übernommen werden. Oder das Update wird auf dem Live-System wiederholt, nach demselben Ablauf und mit frischer Sicherung.

Die zweite Variante ist bei redaktionell aktiven Websites meist praktikabler: Man weiß dann genau, was passiert, weil man es schon einmal gemacht hat. Leg dafür ein Zeitfenster mit wenig Betrieb fest und kündige der Redaktion eine kurze Pause an.

Nacharbeit.

• Cache vollständig leeren, auf allen Ebenen (Cache leeren).
• Suchindex neu aufbauen.
• Zeitgesteuerte Aufgaben prüfen — laufen sie noch?
• Mailversand testen (Mailversand).
• Fehlerprotokoll die ersten Tage beobachten.
• Tempo messen — Contao 5 mit aktuellem PHP ist meist spürbar schneller (Ladezeit).
• Redaktion kurz einweisen, wenn sich im Backend etwas geändert hat.

Der letzte Punkt kostet eine halbe Stunde und erspart eine Woche Rückfragen.

Wenn du nicht weiterkommst.

Wenn der Versionssprung ansteht und du ihn nicht am laufenden System ausprobieren willst. Ich finde die Ursache, behebe sie und erkläre dir, was passiert ist. Bei einem laufenden Ausfall hilft der Notfall-Support, dauerhaft begleitet die Contao-Wartung.

Orientierungswerte, keine Fixpreise — nach einem kurzen Gespräch bekommst du ein Festpreisangebot.

Wer hilft.

Ich bin Manuel Killert, Webentwickler aus Quakenbrück. Content-Management-Systeme sind mein Fachgebiet — ich arbeite seit Jahren damit, unterrichte das Thema als Dozent und kenne die Systeme nicht nur aus der Anwendung, sondern von innen: Datenmodell, Rechtekonzept, Templating, Erweiterungsarchitektur, Betrieb.

Das ist bei Contao besonders nützlich, weil es auf demselben Unterbau aufsetzt wie andere professionelle Systeme. Wer versteht, wie Abhängigkeitsverwaltung, Zwischenspeicherung und Konfigurationsebenen zusammenspielen, findet Fehler schneller — unabhängig davon, welcher Name über dem Backend steht.

Was du von mir bekommst: eine Diagnose in verständlicher Sprache, eine Behebung, die nicht nur das Symptom wegräumt, und eine ehrliche Einschätzung dazu, ob dein System weiterbetrieben, aktualisiert oder abgelöst gehört. Auch wenn die Antwort lautet, dass alles so bleiben kann.