Updates

Was sich in jeder Version geändert hat, steht in der Versionsgeschichte — und im Shop selbst, bevor du ein Update einspielst.

Wie der Shop von Updates erfährt

Einmal täglich nachts fragt der Shop beim Update-Server nach (abschaltbar unter System & Einstellungen → Update-Bezug). Liegt eine neue Version bereit, zeigt System & Einstellungen → System-Update sie an — mit Kurzbeschreibung und der Liste der Änderungen. Jetzt prüfen fragt sofort nach.

Einspielen

Holen und einspielen — danach passiert der Reihe nach:

1. Sicherung der Programmordner (app, config, database, routes, resources, public, platform).
2. Download und Prüfung: Prüfsumme und — wenn ein Schlüssel hinterlegt ist — die digitale Unterschrift des Pakets. Ein verändertes Paket wird abgelehnt.
3. Entpacken mit Schutz gegen manipulierte Pfade im Archiv.
4. Dateien einspielen. Hochgeladene Bilder, die .env und storage/ bleiben unberührt. Dateien, die eine frühere Version mitgebracht hat und die neue nicht mehr kennt, werden entfernt — nur diese, nie etwas, das nicht aus einem Update-Paket stammt.
5. Datenbank anpassen — nur die Schritte, die noch fehlen.
6. Caches leeren, neue Version und Protokoll schreiben.

Ein Paket lässt sich auf derselben Seite auch von Hand hochladen (Update einspielen); der Ablauf ist derselbe.

Zurückrollen

Die Sicherungen stehen unten auf derselben Seite. Wiederherstellen setzt die Programmordner und die Versionsnummer auf den Stand vor dem Update zurück; danach bietet der Shop das Update wieder an. Die Datenbank bleibt dabei unberührt — wer auch sie zurücksetzen will, nimmt eine Datenbanksicherung aus Backups. Auch die Bibliotheken (vendor/) bleiben, wie sie sind: Hat das Update sie geändert, steht nach dem Zurückrollen ein Hinweis im Protokoll, dann einmal den Befehl aus dem nächsten Abschnitt ausführen.

Wenn sich Bibliotheken ändern

Update-Pakete enthalten den Ordner vendor/ nicht, weil eine laufende Installation ihre Bibliotheken schon hat. Ändert eine Version die PHP-Bibliotheken (in der Versionsgeschichte steht dann der Hinweis), einmal per SSH im Shop-Verzeichnis:

composer install --no-dev --optimize-autoloader

Bei Plesk mit abweichender Kommandozeilen-Version:

/opt/plesk/php/8.4/bin/php /usr/lib/plesk-9.0/composer.phar install --no-dev --optimize-autoloader

Bis dahin läuft der Shop weiter; nur Funktionen, die die neue Bibliothek brauchen, melden sich als nicht verfügbar.

Neue Module

Bringt ein Update ein neues Modul mit, steht es unter System & Einstellungen → Plugins als ausgeschaltet und lässt sich dort aktivieren.

Tipp

Einträge mit dem Etikett Sicherheit in der Versionsgeschichte sollten nicht warten.