Contao aktualisieren

Wie die meisten Open-Source-Projekte wird auch Contao kontinuierlich weiterentwickelt. Mit jedem Update werden Komponenten aktualisiert, Fehler behoben, neue Funktionen hinzugefügt oder die Performance verbessert. Es wird daher empfohlen, immer eine aktuelle Version zu verwenden.

Der Contao-Update-Zyklus

Contao folgt für die Versionsbezeichnungen dem Konzept von Semantic Versioning. Das klingt etwas gar technisch weshalb wir uns schnell gemeinsam mit der verwendeten Terminologie vertraut machen:

Major-Release

Bei einem Major-Release handelt es sich um eine komplett neue Version der Software, bei der viele grundlegende Dinge geändert wurden und mit der bereits bestehende Seiten unter Umständen nicht mehr funktionieren. Die aktuelle Major-Version von Contao ist beim Schreiben dieser Zeilen die Version 4.

Minor-Release

Bei einem Minor-Release handelt es sich um eine Art Meilenstein auf dem Weg der Entwicklung, bei dem neue Funktionen hinzugefügt wurden. Kleinere Anpassungen bestehender Seiten können daher notwendig sein. Die aktuelle Minor-Version von Contao ist beim Schreiben dieser Zeilen die Version 4.8.

Bugfix-Release

Bei einem Bugfix-Release handelt es sich um ein Wartungsrelease, dessen primärer Zweck die Behebung von Fehlern ist. Die aktuelle Bugfix-Version von Contao ist beim Schreiben dieser Zeilen die Version 4.8.4.

Long-Term-Support-Versionen

Mit Version 2.11 wurde der Release-Zyklus von Contao angepasst und Long-Term-Support-Versionen (LTS) eingeführt, die 24 Monate lang unterstützt und mit Updates versorgt werden, auch wenn zwischenzeitlich schon neuere Contao-Versionen veröffentlicht wurden. Eine Übersicht aller Contao Versionen gibt es auf Wikipedia.

Aktualisierung mit dem Contao Manager

Vor der Aktualisierung von Contao wird empfohlen, ein Backup der composer.json, composer.lock sowie der Datenbank anzulegen.

Melde dich im Contao Manager an und starte ihn.

Bei einer Aktualisierung für ein Bugfix-Release genügt es auf »Pakete aktualisieren« zu klicken.

Bei einer Aktualisierung für ein Minor-Release klicke bei »Contao Open Source CMS« auf das Zahnrad-Symbol und gebe die gewünschte Version ein. Alle anderen Contao-Paketen müssen ohne Änderung für die Aktualisierung vorgemerkt werden. Durch einen Klick auf die Schaltfläche »Änderungen anwenden« schiebst du die Aktualisierung an.

Aktualisierung für Minor-Release starten

Die Aktualisierung kann nun mehrere Minuten in Anspruch nehmen. Details zum Aktualisierungsprozess können durch Klick auf folgendes Symbol Konsolenausgabe anzeigen/verstecken angezeigt werden.

Aktualisierung für Minor-Release abgeschloßen

Datenbanktabellen aktualisieren

Öffne das Contao-Installtool, und überprüfe, ob nach der Aktualisierung irgendwelche Änderungen an deiner Datenbank notwendig sind. Führe gegebenenfalls die vorgeschlagenen Änderungen durch, und schließe dann das Installtool.

Deine Contao-Installation ist jetzt auf dem neuesten Stand.

Aktualisierung über die Kommandozeile

Vor der Aktualisierung von Contao empfehle ich dir ein Backup der composer.json, composer.lock sowie der Datenbank anzulegen.

Bei der Aktualisierung über die Kommandozeile wird ein composer update ausgeführt, dass wird bei einigen Hostern dazu führen, dass der Prozess wegen der zu hohen Systemanforderung nicht beendet werden kann und die Installation dadurch fehlschlägt. In diesem Fall solltest du den Contao Manager nutzen.

Du hast dich mit deinem Benutzernamen und deiner Domain auf deinem Server angemeldet.

ssh benutzername@example.com

Wechsle dazu auf der Konsole in das Verzeichnis deiner zu aktualisierenden Contao-Installation.

cd www/example/

Bei einer Aktualisierung für ein Bugfix-Release genügt es, folgendes Kommando abzusetzen.

php composer.phar update

Bei einer Aktualisierung für ein Minor-Release muss die gewünschte Version des contao/manager-bundle in der composer.json eingetragen werden.

{
    …
    "require": {
        "contao/manager-bundle": "4.8.*",
        …
    },
    …
}

Jetzt noch die Aktualisierung auf der Kommandozeile anstoßen.

php composer.phar update

Datenbanktabellen aktualisieren

Öffne das Contao-Installtool, und überprüfe, ob nach der Aktualisierung irgendwelche Änderungen an deiner Datenbank notwendig sind. Führe gegebenenfalls die vorgeschlagenen Änderungen durch, und schließe dann das Installtool.

Deine Contao-Installation ist jetzt auf dem neuesten Stand.