Das Skript des Multisite-Installers #

Diese Seite ist für Entwickler, die die Installation von sevenx_multisite ändern oder untersuchen, und für Hoster, die wissen müssen, was eine Standardinstallation mit einer Datenbank und mit settings/ tut. Sie beantwortet: was settings/sevenx-multi-site-installer.php ausführt, wann und in welcher Reihenfolge. Alle Fakten stammen aus der Datei selbst (7692 Zeilen in 6.0.15) und aus kernel/setup/steps/ezstep_create_sites.php und kernel/classes/ezsiteinstaller.php des Kernels.

Inhalt #

1. Die Klasse und wann sie läuft
2. Phase 1: Einstellungen, die der Installer ermittelt
3. Phase 2: die Vorinstallation
4. Phase 3: Einstellungen, Rollen und Voreinstellungen
5. Phase 4: die Schritte der Nachinstallation
6. Wenn ein Schritt scheitert
7. Die Installationsmethode für die Kommandozeile

Die Klasse und wann sie läuft #

Die Datei definiert class sevenxMultiSiteInstaller extends eZSiteInstaller. Der Konstruktor von eZSiteInstaller des Kernels ruft initSettings( $parameters ) und dann initSteps() auf, sodass jedes new sevenxMultiSiteInstaller(...) zuerst seine Einstellungen und seine Liste der Schritte der Nachinstallation ermittelt. Die kleinen Hüllendateien des Pakets (siehe Woraus es besteht) erzeugen jeweils einen und rufen eine Methode auf:

CreateSites (kernel/setup/steps/ezstep_create_sites.php)
  include every <settings-file> of the site package
  eZSitePreInstall()            -> preInstall()
  install the required packages (classes, then content)
  eZSiteINISettings()           -> siteINISettings()
  eZSiteAdminINISettings()      -> adminINISettings()
  eZSiteCommonINISettings()     -> commonINISettings()
  eZSiteRoles()                 -> siteRoles()
  eZSitePreferences()           -> sitePreferences()
  eZSitePostInstall()           -> postInstall() = the 50 steps of initSteps()
  then: exp_adminui in the admin siteaccess, the editor siteaccess, the adminui siteaccess

Die Setup-Frontends (Web-Assistent, Kickstarter, exp:install) führen alle CreateSites aus, sodass das für jede Installationsmethode gleich ist. Siehe Wie der Setup-Assistent Pakete nutzt und Wie der Kickstarter und die Konsole Pakete nutzen.

Phase 1: Einstellungen, die der Installer ermittelt #

initSettings() liest die Parameter, die das Setup übergibt, und speichert, was die späteren Schritte brauchen:

Phase 2: die Vorinstallation #

eZSitePreInstall() erzeugt den Installer mit array( 'var_dir' => 'var/site' ) und ruft preInstall() auf, bevor irgendein Paket installiert wird:

1. Merkt sich die höchste Knoten-ID und Objekt-ID der Basisdaten in $GLOBALS['sevenxBaseMaxNodeID'] und $GLOBALS['sevenxBaseMaxObjectID']. Die Korrektur der Nachinstallation nutzt sie, um Basisdaten von Paketinhalten zu unterscheiden.
2. Fügt der Klasse folder tags (ezkeyword) und publish_date (ezdatetime) hinzu.
3. Setzt [FileSettings] VarDir=var/site für den laufenden Prozess, sodass Bilder und Dateien im var-Verzeichnis der Website landen.
4. activateSiteExtensionSettings(): fügt der laufenden Konfiguration den Ordner settings/ jeder Erweiterung aus extension_list hinzu, sodass die Datentypen und INI-Dateien dieser Erweiterungen bekannt sind, während die Klassen und Objekte importiert werden.
5. Registriert die Verzeichnisse der Datentypen ezstarrating, ezgmaplocation, exp_enhanced_link, eztags und die Datentypen ezsrrating, ezgmaplocation, ngenhancedlink, eztags in content.ini [DataTypeSettings].
6. Fügt der Klasse user das Feld Zweistufige Anmeldung hinzu, wenn extension/sevenx_authentication_2fa existiert.
7. dropExtensionTables(), dann insertDBFile() für jedes Schema einer Erweiterung: Hier kommen die Layouttabellen und ihre Zeilen hinein. Siehe Layoutdaten und share-DBA-Dateien.
8. Korrigiert die Sprach-IDs der Zeilen eng-GB in eztags_keyword und eztags.

Phase 3: Einstellungen, Rollen und Voreinstellungen #

Während CreateSites die Einstellungen baut, fragt es das Paket nach seinen eigenen. Der Installer gibt Listen von INI-Gruppen zurück:

Die Gruppe settings/override/site.ini wird mit discard_old_values geschrieben: Was sie nicht setzt, ist nach der Installation weg. siteRoles() und sitePreferences() geben die Rollen und die Voreinstellungen des Administrators zurück; siehe Rollen und Richtlinien.

Phase 4: die Schritte der Nachinstallation #

postInstall() führt die Liste der Schritte von initSteps() über executeSteps() aus. In Reihenfolge:

Die Details der Schritte 35 bis 41 stehen auf Korrekturen nach der Installation.

Wenn ein Schritt scheitert #

executeSteps() hält beim ersten Schritt an, der einen Fehler meldet, den der Installer nicht behandelt; das eigene handleError() des Installers bestätigt die offene Transaktion bei einem Abbruch. Das Setup meldet dann EZSW-080: Die Nachinstallation des Seitenpakets hielt bei Schritt N von M an, und die Schritte danach liefen nicht. Deshalb ordnet der Code die Schritte so, wie er es tut: Die zwei kosmetischen Schritte für das Logo laufen zuletzt, weil executeSteps die ganze Kette beim ersten Schritt abbricht, der einen Fehler meldet, und mehrere Kernel-Schritte sind überschrieben (swapNodes, removeContentObject, setSection, setRSSExport), um einen Hinweis zu protokollieren und weiterzumachen, wenn das, was sie nennen, nicht da ist.

Tipp Nach einer gescheiterten Installation sagt Ihnen die Schrittnummer in EZSW-080, wo Sie in dieser Tabelle nachsehen. Der Installer und das Setup schreiben ihre Hinweise in die Debug-Ausgabe und einige davon über eZLog::write() in die Logdatei setup.log (zum Beispiel no adminui siteaccess).

Die Installationsmethode für die Kommandozeile #

Die Klasse hat außerdem eine Methode install() für die Nutzung außerhalb von CreateSites. Sie schreibt die Gruppen für den Benutzer-Siteaccess, den Siteaccess der Administration und settings/override selbst und ruft dann updateRoles(), updatePreferences() und postInstall() auf. Die Setup-Frontends nutzen sie nicht; sie gehen über die Hooks oben.

Verwandte Seiten #

• sevenx_multisite
• Installationsskripte in einem Seitenpaket
• Korrekturen nach der Installation
• Das Installerskript ändern
• 4.3 Seitenpakete: was installiert wird
• Seitenpakete: hier beginnen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.