ezupdate: Aktualisierungen und Pakete im Admin #

Diese Seite richtet sich an Administratoren, die eine Installation aktualisieren oder ihr Pakete hinzufügen. ezupdate ("eZ Update") ist der Paketmanager einer Exponential-Installation, im Admin und auf der Kommandozeile.

Eine Installation besteht aus einigen Dutzend Composer-Paketen, einigen Dutzend Extension-Verzeichnissen und ein paar Einstellungen, die entscheiden, welche davon laufen. ezupdate bringt all das auf einen Bildschirm, zeigt, wo die Teile nicht übereinstimmen, und lässt Sie Pakete mit denselben Schutzvorkehrungen aktualisieren und installieren, die Sie auch in einer Shell verwenden würden: eine Prüfung, die nichts verändert, ein Probelauf, eine Bestätigung der Sicherung und die Ausgabe von Composer selbst, während er läuft.

Die Extension erschien erstmals am 2. November 2024 (1.0.1) als Bildschirm für Composer-Updates. Die Releases 1.1.3 bis 1.1.10 (28. September bis 2. Oktober 2026) machten daraus einen vollständigen Paketmanager. Sie öffnen sie unter Setup > Updates und Pakete (/update/dashboard). Die eigenen Anleitungen der Extension (Benutzerhandbuch, installierte Pakete, Konfiguration, Kommandozeile, Sicherheit, Architektur, FAQ) liegen in ihrem Ordner doc/; diese Seite ist die Übersicht.

Was Sie tun können #

Einrichten #

composer require se7enxweb/ezupdate
# settings/override/site.ini.append.php:
#   [ExtensionSettings]
#   ActiveExtensions[]=ezupdate
php bin/php/ezpgenerateautoloads.php --extension
php bin/php/ezcache.php --clear-all

Öffnen Sie Setup > Updates und Pakete. Administratoren sehen den Eintrag sofort. Anderen Rollen gewähren Sie update/ezupdate (ansehen, prüfen, Probelauf) und, wo sie die Installation ändern dürfen, update/manage (aktualisieren, installieren, holen, Server ändern).

Aktualisieren und Installieren sind ausgeschaltet, bis Sie sie einschalten, in settings/override/ezupdate.ini.append.php:

[UpdateSettings]
AllowUpdate=enabled
AllowInstall=enabled

Composer schreibt vendor/ und jedes von ihm verwaltete Paket neu. Schalten Sie diese Einstellungen deshalb nur dort ein, wo das gewollt ist, und mit einer Sicherung (siehe git_manager für Sicherungen aus dem Admin).

Wie ein Update abläuft #

1. Nach Aktualisierungen suchen (composer outdated): verändert nichts.
2. Vorschau (Probelauf) des Updates: zeigt, was Composer ändern würde. Die Spalte „Art“ entscheidet Composer selbst (ein composer update --dry-run über die veralteten Pakete): Kann installiert werden oder Blocked by composer.json (constraint) (das "semver-safe-update" von composer outdated berücksichtigt composer.json nicht). Nur installierbare Pakete haben ein Ankreuzfeld.
3. Bestätigen Sie, dass eine Sicherung vorhanden ist, dann Updates installieren (die angekreuzten Pakete; deaktiviert, mit einer Erklärung, solange AllowUpdate auf disabled steht; Updates einschalten / Ausschalten schreiben settings/override/ezupdate.ini.append.php über den INI-Editor des Kernels). Der Lauf findet im Hintergrund statt; die Seite folgt der Ausgabe. Danach erzeugen die Befehle in [JobSettings] AfterRunCommands[] die Autoloads neu und leeren die Caches für INI, Templates und Inhalte.
4. Wenn ein Lauf endet, zeigt die Seite oben einen Hinweis: Die Installation ist auf dem neuesten Stand! Aktualisieren Sie bald wieder, um sicher zu bleiben., wenn nichts zu installieren, zu aktualisieren oder zu entfernen war (Composers "Nothing to modify in lock file" / "Nothing to install, update or remove" oder null veraltete Pakete nach Nach Aktualisierungen suchen), andernfalls eine kurze Zusammenfassung der Änderungen und, wenn der Lauf fehlschlug, den Exit-Code. Der Hinweis erscheint auch, während Sie den Lauf verfolgen.
5. Kann ein Lauf nicht verfolgt werden, nennt die Seite den Grund: abgemeldet (melden Sie sich wieder an und laden Sie neu; der Lauf geht auf dem Server weiter), mit HTTP 403 abgewiesen (die Richtlinie fehlt) oder ein Serverfehler (die Seite versucht es erneut, wartet jedes Mal länger und hört nach zehn Fehlern in Folge auf).

Einstellungen #

Alle Schlüssel stehen in ezupdate.ini; tragen Sie Ihre Werte in settings/override/ezupdate.ini.append.php ein.

Kommandozeile #

php extension/ezupdate/bin/php/ezupdate.php status
php extension/ezupdate/bin/php/ezupdate.php installed --issues
php extension/ezupdate/bin/php/ezupdate.php outdated
php extension/ezupdate/bin/php/ezupdate.php search seven
php extension/ezupdate/bin/php/ezupdate.php fund --direct --json

Die Befehle sind status, installed [--issues] [--json], outdated, search, show, servers, server-add, server-remove, packagist on|off, packages, fetch, require, update, jobs und fund [--direct] [--json]. Läufe, die in der einen Oberfläche gestartet wurden, erscheinen auch in der anderen.

Sicherheit #

Composer wird ohne Shell gestartet (proc_open mit einer Argumentliste), im Installationsverzeichnis, mit einem Zeitlimit, einem eigenen COMPOSER_HOME, ohne Rückfragen und nur mit übergebenen Pipes (unter Velocity keiner der Sockets des Servers). Serveradressen müssen mit https:// beginnen; jedes Formular trägt das Formular-Token; die Ausgabe von Composer wird maskiert, bevor ihre Farben zu HTML werden, sodass eine Paketbeschreibung mit Markup Text bleibt. Nichts wird in statischen Variablen gehalten, sodass ein persistenter Worker immer die aktuellen Einstellungen liest, und die Ansichten laden ihre Klassen selbst, wenn das Autoload-Array sie noch nicht kennt.

Verhaltensänderungen #

• 1.1.3 entfernte die Ansichten dump und show, das Commit-Template und den Link Dump assets. Sie gehörten zu git_manager und konnten hier nicht funktionieren (eine las git_manager.ini, eine rief eine Klasse GitManager auf, die diese Extension nicht hat, und das Template sendete an git_manager/dashboard). Der Link im Setup-Menü auf git_manager/dump fiel mit ihnen weg; git_manager bringt seinen eigenen mit.
• 1.1.12 zeigt nach jedem abgeschlossenen Lauf einen Ergebnishinweis (auf dem neuesten Stand, was sich geändert hat, fehlgeschlagen).
• 1.1.13 fügt „Updates installieren“ hinzu (Ankreuzfelder pro Paket, deaktiviert mit einer Erklärung, solange Updates ausgeschaltet sind, Einschalten / Ausschalten) und kennzeichnet Pakete danach, was Composer installieren würde.
• Die Lizenztexte liegen seit 1.1.8 in LICENSE.md und doc/LICENSE.md.

Sprachen #

Die Extension bringt Übersetzungsdateien in translations/<locale>/translation.ts mit: eng-US und ger-DE. Die deutsche Datei enthält 280 Meldungen (zählen Sie <message in translations/ger-DE/translation.ts). Die Texte werden in den Kontexten extension/ezupdate, kernel/navigationpart und design/admin/parts/setup/menu nachgeschlagen.

Aktualisieren Sie nach dem Bearbeiten einer Übersetzungsdatei den kompilierten Übersetzungs-Cache mit ./console exp:ezgeneratetranslationcache und leeren Sie die Template- und Inhalts-Caches. ./console exp:ezchecktranslation ger-DE gibt Statistiken zur share/translations/ger-DE/translation.ts des Kernels aus, nicht zur Datei dieser Extension.

Verwandte Seiten #

• git_manager: Sicherungen vor dem Aktualisieren
• Paketlizenzen und -versionen
• Velocity-Engines
• Abstraktionen für CLI, Cronjobs und Ansichten
• Chronik und Versionshinweise
• Änderungsverzeichnis
• Verhaltensänderungen der Extensions
• Monate: 2024-11, 2026-06, 2026-09, 2026-10 (alle Extensions)