Contao 3 Update durchführen

Je nach Größe und Umfang des Updates und der Website solltest du dir vorher überlegen, ob du das Update direkt auf dem Live-Server durchführen kannst oder besser eine Kopie der Installation erstellst und dann die Aktualisierung auf einem Test- bzw. Entwicklungssystem durchführst.

Kein Update ohne Backup!

Egal, für welche Variante du dich entscheidest. Du solltest vor jedem Update ein komplettes Backup der Datenbank und Dateien durchführen! Außerdem solltest du immer prüfen, welche zusätzlichen Erweiterungen du in Contao nutzt. Diese müssen ebenfalls mit der neuen Version kompatibel sein und aktualisiert werden.

Plane zudem immer genügend Zeit für das Update ein.

In diesem Beitrag stelle ich dir das Update im Schnelldurchgang vor. Wenn du detaillierte Video-Anleitungen möchtest, dann empfehle ich dir die Mitgliedschaft in der Contao Academy.

Beim manuellen Update gibt es zwei unterschiedliche Varianten. Hier kannst du entweder nur die geänderten Dateien auf den Server hochladen (a) oder komplette Contao-Installation austauschen (b).

Wie das funktioniert, ist hervorragend in der alten Contao 3.5 Doku beschrieben. Hier nur kurz die wichtigsten Schritte:

1. Backup erstellen: Vor dem Update solltest du ein vollständiges Backup deiner Dateien und Datenbank anfertigen, um Datenverluste zu vermeiden.
2. Aktuelle Version herunterladen: Lade die letzte Contao 3 Version herunter.
3. Dateien ersetzen: Entpacke die heruntergeladene Version lokal und überschreibe die alten Dateien auf deinem Server. Nutze dazu z. B. Filezilla oder WinSCP. Achte darauf, die Datei config/config.php und das Verzeichnis files nicht zu überschreiben.
4. Datenbank aktualisieren: Rufe nun das Contao-Installtool auf, um die Datenbankstruktur an die aktuelle Version anzupassen.
5. Cache leeren: Leere den Cache von Contao, um sicherzustellen, dass alle Änderungen übernommen werden.
6. Testen: Überprüfe deine Website nach dem Update auf mögliche Probleme oder Fehlfunktionen.

Diese Variante wird besonders bei größeren Versionssprüngen empfohlen, insbesondere wenn du ein Update von Contao 2 auf Contao 3 durchführen möchtest.

Für solche umfangreichen Updates solltest du immer eine Kopie deiner aktuellen Installation erstellen und mit einem Testserver oder einer Subdomain arbeiten. Beachte, dass dies mehrere Stunden in Anspruch nehmen kann. Zudem können Anpassungen an Templates und Modulen erforderlich sein.

Der Vorteil eines vollständigen Uploads der neuen Contao-Version besteht darin, dass keine Altlasten mehr auf dem Server verbleiben, was in der Regel zu weniger Problemen führt. Allerdings ist der Aufwand deutlich höher, als lediglich die geänderten Dateien auf den Server zu laden.

Bei einer Neuinstallation gehst du wie folgt vor:

1. Letzte Contao 3 Version herunterladen (https://github.com/contao/core/releases)
2. ZIP-Datei lokal entpacken
3. Komplettes Verzeichnis in einen neuen Ordner auf dem Webserver hochladen
4. Neue Subdomain erstellen, wobei das Stammverzeichnis auf den neuen Ordner zeigt
5. Benutzerdateien und Verzeichnisse von der alten Installation auf die neue kopieren, insbesondere:
   • files
   • templates
   • /system/modules (ggf. inkompatible Module aktualisieren)
   • /system/config/localconfig.php
   • /system/config/langconfig.php
   • /system/config/dcaconfig.php
6. Neue leere Datenbank erstellen
7. Bestehende Datenbank exportieren und in die leere Datenbank importieren (phpMyAdmin nutzen)
8. Neue Datenbankinformationen in localconfig.php eintragen
9. Contao-Installtool aufrufen und Datenbank aktualisieren
10. Frontend prüfen und ggf. Nacharbeiten durchführen
11. Wenn alles funktioniert, kann die aktualisierte Version mit der Hauptdomain verknüpft werden.

Je nach deinem Kenntnisstand in Contao und dem Umfang deiner Contao-Installation solltest du prüfen, welche Update-Variante am besten für dich geeignet ist. Wenn du keine Erfahrung mit Contao-Updates hast, kann es ratsam sein, einen Contao-Experten zu beauftragen.

Achte darauf, dass alle installierten Erweiterungen mit der neuen Contao-Version kompatibel sind.

Unterschätze den Zeitaufwand nicht und vergiss nicht, vorher ein vollständiges Backup deiner Dateien und der Datenbank zu erstellen.