Exponential 6 und Exponential Platform Nexus #

Exponential Platform Nexus (se7enxweb/exponential-platform-nexus) ist eine vollständige Site-Distribution: Exponential Layouts mit seinem visuellen Editor, die Netgen Media-Site, Tags, die Site API und eine Administration, auf je einer Generation von Exponential Platform pro Release-Linie. Die Legacy-fähigen Linien betreiben über die Legacy-Bridge außerdem den Kernel von Exponential 6.

Übersicht Migration · Checkliste · Das eigene Handbuch des Produkts: Nexus, Kapitel 12: Migration nach Nexus und Kapitel 11: Upgrade zwischen Linien

Inhalt #

• 1. Die Release-Linien
• 2. Welche Linie Sie anstreben sollten
• 3. Von Exponential 6 zu Nexus
• 4. Seitenaufbau: Exponential Layouts auf Nexus und im Legacy-Kernel
• 5. Von Nexus zu Exponential 6
• 6. Prüfen, Rückweg
• 7. Risiken
• 8. Checkliste

1. Die Release-Linien #

„Nexus 2.5“, „Nexus 4.x“ und „Nexus 5.x“ sind die Plattform-Generationen innerhalb von Nexus, nicht seine Versionsnummern. Ausgelesen aus der composer.json der Release-Tags am 2026-10-18:

Verwandte Produkte: CJW Exponential Platform Nexus (se7enxweb/cjw-exponential-platform-nexus, 1.0.0.12, die Generation 2.5 mit Exponential 6 und mitgelieferten Vendor-Dateien), dessen Starter (1.0.0.3) und der Nexus Starter (se7enxweb/exponential-platform-nexus-starter, 1.0.0.0, Platform v5, kein Legacy-Kernel in seiner composer.json).

Warnung Fordern Sie bei Composer oder Git immer eine ausdrücklich angegebene Nexus-Version an. Das Repository enthält Tags der Netgen Media-Site, von der es abgezweigt wurde; ein composer create-project ohne Version kann daher eines davon statt Nexus installieren (Kapitel 16.1).

2. Welche Linie Sie anstreben sollten #

Die Regel des Produkts lautet zuerst dieselbe Generation. Eine Exponential-6-Datenbank ist eine Legacy-Datenbank, also:

Die Linien 1.0.0.x bis 1.2.0.x halten die Legacy-Administration und Ihre Legacy-Extensions lauffähig, während Sie portieren. 1.3.0.x ist eine reine Symfony-Anwendung: Das Handbuch des Produkts führt auf, was wegfällt (die Legacy-Bundles, ezpublish_legacy/, der Legacy-Cron, die Siteaccesses legacy_admin und ngadminui).

3. Von Exponential 6 zu Nexus #

Kapitel 12.4 des Produkts („From eZ Publish 4.x and Exponential 6“) beschreibt das Verfahren; kurz gesagt:

1. Bestandsaufnahme, Einfrieren, Sichern (Checkliste).
2. Bringen Sie die Datenbank auf das neueste Schema von Exponential 6 (Kapitel 11) und prüfen Sie sie mit ezsqldiff.php, zuerst das Referenzschema und dann Ihre Datenbank.
3. Legen Sie die Tabellen an, die der Kernel 2.5 erwartet und die einer reinen Legacy-Datenbank fehlen: Vergleichen Sie mit data/mysql/schema.sql des installierten se7enxweb/ezpublish-kernel 7.5 und legen Sie die fehlenden an (Kapitel 16.6.1).
4. Legen Sie das Nexus-Projekt 1.0.0.x aus einem Release-Tag an (zum Beispiel git clone -b 1.0.0.x ... und git checkout 1.0.0.11, dann composer install). Führen Sie den Installer nicht gegen Ihre Datenbank aus: Er baut ein Repository von Grund auf neu. Das Paket mit den Demodaten kann installiert bleiben; nur der Installer liest es.
5. Legen Sie Ihre Legacy-Extensions und Siteaccess-Einstellungen dort ab, wo das Projekt sie hält (src/AppBundle/ezpublish_legacy/, von den Skripten des Projekts nach ezpublish_legacy/ verlinkt), kopieren Sie den Speicher nach ezpublish_legacy/var/<site>/storage und richten Sie app/config/parameters.yml auf die Datenbank aus.
6. Ersetzen Sie die Host-Zuordnung der Demo in der Siteaccess-Konfiguration durch Ihre eigenen Hostnamen.
7. Legen Sie die Tabellen von Exponential Layouts an (die Layouts-Migrationen unter MySQL oder die Schemadatei, die das Layouts-Paket mitliefert) und setzen Sie die Ort-Parameter des Site-Bundles (ngsite.default.locations.site_info.id, ngsite.default.locations.tree_root.id und die übrigen, die Kapitel 12.9 des Produkts aufführt) auf Orte in Ihrem Baum. Eine falsche ID führt zu einem 404 oder einem leeren Block, nicht zu einem Fehler bei der Bereitstellung.
8. Lassen Sie die Legacy-Siteaccesses weiterlaufen (legacy_mode: true), während der öffentliche Siteaccess Inhaltstyp für Inhaltstyp auf Twig-Templates und Exponential Layouts umzieht.
9. XmlText bleibt unter 1.0.0.x XmlText (se7enxweb/ezplatform-xmltext-fieldtype v1.8.11 gehört zum Projekt). Wandeln Sie mit ezxmltext:convert-to-richtext (aus diesem Paket) nur dann in RichText um, wenn Sie es in der Symfony-Administration brauchen, spätestens aber vor dem Wechsel auf 1.1.0.x.
10. Passwörter: Der Kernel 2.5 akzeptiert die Legacy-Hash-Typen; ab 3.0 funktionieren nur die Typen 6 und 7. Bitten Sie Benutzer mit älteren Typen um ein Zurücksetzen, bevor Sie auf 1.1.0.x wechseln.
11. Bauen Sie Caches, Assets und den Suchindex auf, prüfen Sie und proben Sie die Umstellung an einer frischen Kopie.

Ihre eigenen Inhaltstypen werden mit Ihren eigenen Templates dargestellt: Ordnen Sie sie in der View-Konfiguration zu, statt sie in die Demo-Typen ng_* umzubenennen.

4. Seitenaufbau: Exponential Layouts auf Nexus und im Legacy-Kernel #

Exponential Layouts (se7enxweb/explayouts) ist die Portierung der Upstream-Layouts-Pakete auf den Kernel von Exponential 6: dieselbe Datenstruktur auf explayouts_*-Tabellen, der Editor als Legacy-Modul (Kapitel 16.6.7). Es sind zwei Implementierungen; es gibt keinen Befehl, der die eine in die andere kopiert.

Layouts verweisen über ID oder Remote-ID auf Inhalte. Halten Sie die Remote-IDs identisch, wenn Inhalte zwischen Installationen umziehen, sonst zeigen die Blöcke ins Leere (Kapitel 12.11 des Produkts).

5. Von Nexus zu Exponential 6 #

Der Wechsel von einer Nexus-Linie zurück zu Exponential 6 allein ist „Pfad B“ aus Kapitel 16.6:

• Von 1.0.0.x bis 1.2.0.x: Der Legacy-Kernel ist bereits vorhanden. Installieren Sie Exponential 6, übernehmen Sie die Legacy-Einstellungen, Extensions und den Speicher, wenden Sie die Update-Dateien von Exponential 6 an und liefern Sie die Site mit Velocity oder PHP-FPM aus. Die Seite zu Platform Legacy enthält dieselben Schritte (Abschnitt 5).
• Von 1.3.0.x: Die Datenbank hat die v5-Tabellennamen ibexa_* und keine reinen Legacy-Tabellen. Folgen Sie Kapitel 16.6.4 (die Umbenennungen oder die Übersetzer-Extension) und 16.6.9 (Zeile „5.0“), legen Sie die reinen Legacy-Tabellen neu an und wandeln Sie RichText um oder stellen Sie es dar (16.6.3).
• Layouts: Bauen Sie die Nexus-Layouts im Legacy-Kernel neu auf, oder kopieren Sie die Zeilen und führen Sie die beiden Umwandlungsbefehle aus Abschnitt 4 aus. Das Media-Design gibt es für den Legacy-Kernel als se7enxweb/sevenx_themes_media.
• Twig-Templates werden von Hand zu TPL; ein Konverter trifft die Syntax, nicht die Semantik (16.6.7).

6. Prüfen, Rückweg #

Prüfen Sie so, wie es das Handbuch des Produkts beschreibt: Zahlen vorher und nachher, die Startseite und eine Seite pro Inhaltstyp, eine über Layouts verwaltete Seite, den Layouts-Editor, eine Bildvariante, die Suche, Formulare, die Anmeldung eines Redakteurs und eines Benutzers mit einem alten Passwort-Hash. Für den Rückweg lassen Sie die Quelle unangetastet, bis sich die Umstellung bewährt hat; alle Arbeiten erfolgen an Kopien.

7. Risiken #

8. Checkliste #

• To do: Linie nach Generation gewählt (1.0.0.x ausgehend von Exponential 6); Version ausdrücklich angegeben.
• To do: Datenbank auf dem neuesten Schema von Exponential 6; 2.5-Tabellen ergänzt; ezsqldiff.php ohne Befund.
• To do: Projekt aus einem Release-Tag; Installer nicht auf den Daten ausgeführt; Host-Zuordnung der Demo ersetzt.
• To do: Legacy-Extensions, Einstellungen und Speicher an ihrem Platz; Legacy-Siteaccesses auf legacy_mode.
• To do: Layouts-Tabellen vorhanden; Ort-Parameter des Site-Bundles zeigen auf Ihren Baum.
• To do: Seitenstrukturen als Layouts und Regeln neu aufgebaut; Remote-IDs beibehalten.
• To do: Strategie für XmlText festgelegt; Zurücksetzen von Passwörtern vor 3.0 geplant.
• To do: Während des Einfrierens an einer frischen Kopie geprüft; Rückweg abgestimmt.

Diese Seite ist Teil der Exponential-Dokumentation und freie Dokumentation unter der GNU Free Documentation License 1.3 oder einer späteren Version (die Lizenz dieser Dokumentation).