Eine Paketinstallation, die große Pakete übersteht #

Diese Seite ist für alle, die ein Website-Paket im Browser installieren und erlebt haben, dass es in eine Zeitüberschreitung läuft. Die Installation eines Website-Pakets (Inhalte, Klassen und Design einer Demo-Website) ist das Längste, was der Einrichtungsassistent und Setup > Pakete tun. Seit Juni 2026 (Entwicklung von Release 6.0.15, Commits 277ec0ae12 und 86911400dd) ist der Installer auf drei Arten gehärtet:

1. Jedes Paketelement wird in einer eigenen Transaktion installiert. Scheitert ein Element, werden seine Schreibvorgänge zurückgerollt, statt ein halbes Element in der Datenbank zu hinterlassen, und die Installation endet mit einem klaren Fehler, der das Element nennt.
2. Der Browser installiert in Teilschritten. Die Seite installiert einige Elemente, leitet dann auf sich selbst weiter und macht weiter, sodass keine einzelne Anfrage so lange läuft, dass sie an das Zeitlimit des Webservers oder von PHP stößt.
3. Die Größe eines Teilschritts ist eine Einstellung. Langsame Hardware kann kleinere Teilschritte verwenden, schnelle Hardware größere.

Einstellungen #

Datei settings/package.ini, Block [InstallerSettings]:

Ein Teilschritt endet, wenn eine der beiden Grenzen erreicht ist. Findet der Code keine der beiden Einstellungen, verwendet er 8 Elemente und 3 Sekunden. Beispiel für eine Überschreibung auf einem langsamen Shared Host:

# settings/override/package.ini.append.php
[InstallerSettings]
InstallBatchMaxItems=4
InstallBatchTimeBudgetSeconds=3

Leeren Sie danach den INI-Cache (php bin/php/ezcache.php --clear-tag=ini --allow-root-user).

Was der Installer jetzt prüft #

eZPackage::installItem() (kernel/classes/ezpackage.php) lehnt ein Element ab, das:

• keinen type hat;
• für seinen Typ keinen Installations-Handler hat;
• XML-Inhalt haben sollte, dessen Datei sich aber nicht lesen lässt oder leer ist.

Es beginnt eine Datenbanktransaktion, führt den Handler aus und rollt zurück, wenn der Handler false zurückgibt, wenn die Transaktion ungültig wurde oder wenn der Handler eine Ausnahme wirft. Eine Ausnahme gelangt nicht mehr bis zur Seite; sie wird protokolliert und als Installationsfehler angezeigt. eZPackage::install() (alle Elemente) hält beim ersten fehlschlagenden Element an, sofern der Aufrufer nicht den Parameter continue-on-error setzt, und markiert das Paket nur dann als installiert, wenn jedes Element erfolgreich war.

Die Installationsansicht hebt außerdem max_execution_time von PHP für die Anfrage auf, sodass auch ein einzelnes großes Element nicht an die Grenze stößt.

Wenn eine Installation anhält #

Die Fehlerseite nennt Typ und Namen des Elements. Beheben Sie die Ursache (eine fehlende Extension, ein Datenbankfehler in der Debug-Ausgabe) und starten Sie dann den Installationsschritt erneut. Die Ansicht behält die Position des aktuellen Elements (currentItem) zwischen Anfragen in den dauerhaften Daten des Installationsschritts (kernel/private/classes/views/package/install.php); in den Templates gibt es keine Schaltfläche namens „Retry“, laden Sie also den Installationsschritt neu, statt eine zu suchen.

Verwandte Seiten #

• ezpm: der Paketmanager auf der Kommandozeile, in ein Paket hineinsehen, es mit Ihrer Website vergleichen, einzelne Elemente importieren
• Kickstarter: eine ganze Website aus einer Datei installieren, Exponential mit einem Befehl installieren
• MongoDB-Datenbankunterstützung (die Änderungen am Assistenten in denselben Wochen)
• Installer-Protokolle und Startdaten
• Changelog 6.0.15
• Chronik: Juni 2026, zweite Hälfte