upgrade

Überblick

upgrade macht die Modulpflege planbar: zuerst den Plan prüfen, danach ein einzelnes Modul oder die gesamte Installation aktualisieren, kompatible Abhängigkeiten reparieren und mit installiertem run optional einmal pro autorisierter Sitzung automatisch prüfen oder aktualisieren.

Erst planen, dann Code ersetzen

upgrade -c prüft Versionen, Pakete und Abhängigkeiten ohne Modulcode zu schreiben. Ein echtes Update bewahrt Paket und Repository, ersetzt atomar und ruft install nur für vollständig fehlende Pflichtabhängigkeiten auf.

Syntax

upgrade [module ...] [-c] · upgrade -auto <check|update|off> · upgrade -info

Referenz

Handbuch zu upgrade

In Minimum sind nur das Aktualisieren aller Module oder eines benannten Moduls verfügbar. Prüfmodus, mehrere Namen und Automatik benötigen Base.

Vor Änderungen an einer laufenden Website zuerst upgrade -c ausführen: Es prüft Versionen und Abhängigkeiten, ohne Modulcode zu ersetzen. upgrade hash -c beschränkt die Prüfung auf ein Modul.

upgrade hash aktualisiert oder repariert ein installiertes Modul und behält dessen Base-/Minimum-Ausgabe und Repository bei. Ohne Modulnamen werden alle installierten Erweiterungen geprüft. Fehlende Module installiert install.

upgrade -auto check legt über run und autoload.lil eine Prüfung beim autorisierten Sitzungsstart an. -auto update darf PHP-Code automatisch ersetzen und ist standardmäßig deaktiviert. upgrade -info zeigt den Modus, -auto off schaltet ihn ab. Core-Befehle wie cd benötigen ein neues lil.php.

Planung

Jeder installierte Marker speichert Repository, Version, Base- oder Minimum-Paket und lil.core-Generation. upgrade ermittelt im selben Repository die neueste kompatible öffentliche Version, behält das Paket bei, prüft die Kompatibilitätsmetadaten und stuft eine lokal vorausliegende Version niemals zurück.

Aktualisierung und Reparatur

Vorhandene Module werden geladen, normalisiert, analysiert, auf Methodenkonflikte geprüft und atomar ersetzt. Bei Abhängigkeiten werden Repository, Paket, Version und Kern-Generation geprüft. Eine bereits installierte Abhängigkeit aktualisiert oder erweitert upgrade selbst; nur eine vollständig fehlende Abhängigkeit wird an install übergeben.

Prüfmodus

-c führt dieselbe Versions-, Paket- und Abhängigkeitsanalyse aus, lädt aber keinen Modulquelltext und schreibt die Erweiterungsdatei nicht. Für wichtige Installationen ist dies der beste erste Schritt vor einem manuellen oder automatischen Update.

Automatischer Modus

Der optionale automatische Modus nutzt den vorhandenen Startmechanismus von run und dessen autoload.lil. upgrade verändert ausschließlich den eigenen markierten Block # <upgrade:auto> und lässt alle anderen Zeilen unverändert. check hinterlegt upgrade -c, update hinterlegt upgrade und off entfernt nur diesen verwalteten Block. check und update schließen einander aus.

Da autoload.lil einmal pro autorisierter Sitzung läuft, wird die gewählte Aktion nach der Anmeldung ausgeführt und nicht vor jedem Befehl. Für den Automatikmodus ist run erforderlich. upgrade -info zeigt den aktuellen Modus ohne Schreibzugriff.

Sicherheit

Automatische Updates sind standardmäßig deaktiviert. update lädt ausführbaren PHP-Modulcode und ersetzt ihn; verwenden Sie daher nur ein vertrauenswürdiges Repository. Wenn Änderungen ausdrücklich bleiben sollen, wählen Sie check. Mit upgrade -auto off lässt sich der verwaltete Eintrag jederzeit entfernen.

Zusammenfassungsformat

Prüfungen und Aktualisierungen der gesamten Installation beginnen mit einer kompakten Summe, zeigen geänderte Module als versionsorientierte Zeilen wie v1.30 > v1.33 help ⌘ und enden mit Zählern wie Aktuell: 10. Mehrere Aktualisierungen lassen sich dadurch schnell vergleichen.

Die integrierten Befehle cd und core gehören zur Core-Version; upgrade zeigt ihren Status an, zum Aktualisieren muss lil.php ersetzt werden.

Base-Pakete sind mit ⌘ markiert; Minimum bleibt als (minimum) gekennzeichnet.

Ergebnis für ein Modul

Bei der Prüfung oder Aktualisierung eines Moduls erscheinen nur Version und Paketkennung, etwa v1.1.5 ⌘ oder v1.1.4 > v1.1.5 ⌘, ohne Modulnamen oder Current/Available. Bei fehlendem Quelltext wird dieselbe Version einmal erneut angefragt.

upgrade akzeptiert jetzt mehrere Modulnamen in einem Aufruf, auch mit -c. Nur ausgewählte Module und notwendige Abhängigkeiten werden bearbeitet.

Installieren und verwalten

Installieren Sie die aktuelle kompatible Version. Wählen Sie Base für den vollständigen Funktionsumfang oder Minimum für das reduzierte Paket; ein bereits installiertes Modul wird mit upgrade aktualisiert.

Base und Minimum sind zwei Pakete derselben aktuellen Modulversion.

Beispiele

Die Beispiele sind kopierbar, werden aber nicht von der Website ausgeführt. Prüfen Sie Pfade, Rechte und destruktive Optionen.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
Status  All 3 modules are current
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
All installed extension modules are current
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
v1.1.4
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
v1.1.4
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
v1.1.5
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
Selected (check)  3
attr     v1.3.2
stat     v1.1.6
include  v1.2.6
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
All 3 selected modules are current
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
Built-in  cd · Core v1.5.x
Update    replace lil.php to update
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
Built-in  core · Core v1.5.x
Update    replace lil.php to update
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
Automatic upgrade  Check only
Session command     upgrade -c
Script              autoload.lil
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
Automatic upgrade  Update automatically
Session command     upgrade
Script              autoload.lil
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
Automatic upgrade  Off
Script             autoload.lil
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
missing_module: not installed

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
?

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
?

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
?

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
v1.4.8
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
v1.3.6
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Vorbereitete Übungsausgabe. Play verändert deine Installation nicht.
Selected (check)  2
hash  v1.1.4
pwd   v1.1.5
Das Ergebnis hängt von installierten Paketen und dem Repository ab.

Verwandte Befehle

Ein violetter Befehlslink bedeutet, dass diese Funktion ein anderes Modul verwendet. Öffnen Sie den verknüpften Befehl, um dessen Aufgabe und Installation nachzusehen.

Verwandte Dokumentation