Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Legacy Bridge: Exponential 6 innerhalb der Symfony-Plattform betreiben

Diese Seite richtet sich an Teams, die eine Exponential-6-Site auf die Symfony-Plattform umziehen oder auf der öffentlichen Site Twig einsetzen möchten, während die Redakteure die Legacy-Administrationsoberfläche…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/features/6.0/legacy-bridge.md

On this page

This page is a translation. Read the English original

Legacy Bridge: Exponential 6 innerhalb der Symfony-Plattform betreiben

Diese Seite richtet sich an Teams, die eine Exponential-6-Site auf die Symfony-Plattform umziehen oder auf der öffentlichen Site Twig einsetzen möchten, während die Redakteure die Legacy-Administrationsoberfläche behalten. Referenz: Spezifikation des Legacy-Bridge-Bundles.

Repositories: se7enxweb/legacy-bridge (Composer-Paket, Repository legacyBridge), se7enxweb/ibexa-legacy-bridge (Portierung für Platform 4), se7enxweb/site-legacy-bundle, se7enxweb/ngsymfonytools, se7enxweb/exponential-legacy-installer.

Was es ist

Die Legacy Bridge ist ein Symfony-Bundle, das den Kernel von Exponential 6 (das System, über das Sie hier lesen) innerhalb einer Installation der Symfony-Plattform lädt. Eine einzige Webanwendung bedient dann beide Welten:

  • die Legacy-Administrationsoberfläche und die Legacy-Templates (Ihre .tpl-Dateien, Ihre Extensions, Ihre Inhaltsklassen) über den Siteaccess legacy_admin;
  • den neuen Stack (Twig-Templates, Symfony-Routen, REST, GraphQL, die Administrationsoberfläche der Plattform).

Beide lesen dieselbe Datenbank. Inhalte, die Redakteure in der Legacy-Administrationsoberfläche anlegen, erscheinen im Twig-Frontend, und umgekehrt.

Wozu Sie es einsetzen

  • Sie haben eine Exponential-6-Site und möchten auf die Symfony-Plattform umsteigen, ohne die Redakteure auszusperren. Betreiben Sie beides, bis die Migration abgeschlossen ist.
  • Sie möchten Twig, das Symfony-Routing oder den Seitenbaukasten Exponential Layouts für die öffentliche Site nutzen, Ihre Redakteure behalten aber die vertraute Legacy-Administrationsoberfläche.
  • Sie halten Legacy-Extensions (zum Beispiel ezjscore, eztags, ezwebin) in einem Plattformprojekt verfügbar.

Welche Version für welche Plattform

Das Paket hat eine Linie je Plattformgeneration: Die Linie für Platform 2.5 wird auf master getaggt, die späteren Linien haben jeweils einen eigenen Branch. Die Tags sind in der Release-Historie aufgeführt.

Branch / TagsPlattformSymfonyPHPBenötigt
master (v2.1.10 bis v2.1.12, 2025-08 bis 2026-04)eZ Platform 2.5 LTS3.48.x mit Korrekturenden Legacy-Kernel von Exponential
3.x (3.0.0.1 bis v3.0.0.37, 25.03. bis 11.04.2026)eZ Platform 3.35.4^8.0se7enxweb/exponential ^6.0.12, ezsystems/ezplatform-kernel ~1.3
4.x (v4.0.0.0 bis v4.0.0.3, 06.04. bis 17.04.2026)mit Ibexa 4.6 kompatible Installationen5.4^8.0se7enxweb/exponential dev-main
5.x (v5.0.0.0, v5.0.1 bis v5.0.10)Platform v57.4^8.4zusätzlich se7enxweb/site-bundle, se7enxweb/site-legacy-bundle, se7enxweb/ngsymfonytools

Installation (Projekte im Stil von Platform 2.5)

composer require --update-with-all-dependencies "se7enxweb/legacy-bridge"
  1. Aktivieren Sie das Bundle in app/AppKernel.php: Fügen Sie new eZ\Bundle\EzPublishLegacyBundle\EzPublishLegacyBundle( $this ), am Ende des Arrays $bundles hinzu. Das Argument $this ist erforderlich.
  2. Bereiten Sie das Projekt vor:
php bin/console ezpublish:legacy:init

Die Linie für Platform 2.5 (v2.1.x, auf master) kennt nur die Befehlsnamen ezpublish:*; die unter Konsolenbefehle beschriebenen Namen exponential:legacy:* gibt es dort nicht.

Der Befehl gibt aus, was als Nächstes zu tun ist: Verschieben Sie Ihre Legacy-Dateien (Extensions, Einstellungen, optional Designs) in das Projekt und fügen Sie dann den Siteaccess legacy_admin zur Siteaccess-Liste list und zur genannten site_group hinzu. Das Legacy-Backoffice benötigt für diesen Siteaccess legacy_mode: true, was der Initialisierungsschritt an das Ende Ihrer Plattformkonfiguration schreibt.

  1. Führen Sie composer symfony-scripts ein- oder zweimal aus, damit die Assets erzeugt und verlinkt werden.
  2. Optional: Erlauben Sie den Legacy-Einrichtungsassistenten in app/config/security.yml:
ezpublish_setup:
    pattern: ^/ezsetup
    security: false
  1. Fügen Sie die Legacy-Rewrite-Regeln zu Ihrem Apache-Virtual-Host hinzu, damit Legacy-Assets als Dateien ausgeliefert werden (Bilder im Speicher, design, share/icons, Designs der Extensions, packages/styles, var/storage/packages); eine Entsprechung für Nginx steht in der INSTALL.md der Bridge.
  2. Korrigieren Sie die Berechtigungen wie bei jedem Plattformprojekt.

Fehlende Legacy-Extensions, die ältere Kernel mitbrachten (ezfind, eztags, der Skriptmonitor, die Extension für Systeminformationen), fügen Sie mit composer require zur composer.json des Projekts hinzu.

Cache-Verhalten

Standardmäßig leert die Bridge auch den Persistenz-Cache (SPI) der Plattform, wenn der Legacy-Cache für Inhaltsansichten geleert wird, und bin/console cache:clear leert ihn ebenfalls. Beides lässt sich in der Plattformkonfiguration einzeln abschalten:

DateiSchlüsselStandardWirkung
Plattformkonfiguration (zum Beispiel app/config/ezplatform.yml)ez_publish_legacy.clear_all_spi_cache_from_legacytrueSPI-Cache leeren, wenn der Legacy-Ansichts-Cache geleert wird
dieselbeez_publish_legacy.clear_all_spi_cache_on_symfony_clear_cachetrueSPI-Cache bei cache:clear leeren
dieselbeez_publish_legacy.enabledtrueBridge ein oder aus
dieselbeez_publish_legacy.root_dirkeinerPfad des Legacy-Wurzelverzeichnisses; muss existieren
dieselbeez_publish_legacy.legacy_aware_routesleere ListeRouten (oder Routenpräfixe), die bei aktivem legacy_mode erlaubt sind
Siteaccess-Geltungsbereichez_publish_legacy.<scope>.legacy_modenicht gesetztden Legacy-Kernel URL-Aliase verarbeiten lassen
Siteaccess-Geltungsbereichez_publish_legacy.<scope>.templating.view_layoutnicht gesetztTwig-Pagelayout, wenn eine Inhaltsansicht im Legacy-Kernel gerendert wird
Siteaccess-Geltungsbereichez_publish_legacy.<scope>.templating.module_layoutnicht gesetztTwig-Pagelayout für Legacy-Module (sonst das Legacy-Pagelayout)

Konsolenbefehle

Die sechs Befehle der Bridge wurden im April 2026 umbenannt, und zwar nur in den Linien 3.x, 4.x und 5.x. Die alten Namen bleiben dort als veraltete Aliase erhalten, sodass Skripte weiter funktionieren.

Linie der BridgeVerfügbare Befehlsnamen
master (v2.1.10 bis v2.1.12, Platform 2.5)nur die alten Namen ezpublish:*
3.x bis v3.0.0.29nur die alten Namen ezpublish:*
3.x ab v3.0.0.30exponential:legacy:*, mit den alten Namen als Aliase
4.x v4.0.0.0 und v4.0.0.1nur die alten Namen ezpublish:*
4.x ab v4.0.0.2exponential:legacy:*, mit den alten Namen als Aliase
5.x (alle Tags)exponential:legacy:*, mit den alten Namen als Aliase
BefehlAlter Name (Alias)Funktion
exponential:legacy:initezpublish:legacy:initbereitet die Plattforminstallation für den Legacy-Betrieb vor
exponential:legacy:configureezpublish:configureerzeugt die Plattformkonfiguration aus einem vorhandenen Legacy-Verzeichnis
exponential:legacy:install-extensionsezpublish:legacybundles:install_extensionsinstalliert Legacy-Extensions, die Symfony-Bundles definieren (standardmäßig als symbolischer Link)
exponential:legacy:symlinkezpublish:legacy:symlinkinstalliert Legacy-Einstellungen und Design-Dateien aus src nach ezpublish_legacy/
exponential:legacy:assets-installezpublish:legacy:assets_installinstalliert Legacy-Assets und Front-Controller-Wrapper (zum Beispiel index_cluster.php)
exponential:legacy:scriptezpublish:legacy:scriptführt ein Legacy-CLI-Skript im eingebundenen Kernel aus

Beispiel: ein Legacy-Skript mit den Datenbankeinstellungen der Plattform ausführen. Der Skriptpfad ist relativ zum Legacy-Wurzelverzeichnis; alle weiteren Optionen werden an das Legacy-Skript weitergereicht, und --legacy-help zeigt die Hilfe des Skripts selbst:

php bin/console exponential:legacy:script bin/php/ezcache.php --legacy-help
php bin/console exponential:legacy:script bin/php/ezcache.php --clear-id=content --siteaccess=legacy_admin

SQLite

Seit v4.0.0.1 (07.04.2026) kann auch eine Plattforminstallation auf SQLite den Legacy-Kernel ausführen. Die Bridge ordnet den Doctrine-Treiber pdo_sqlite der Legacy-Einstellung DatabaseImplementation=sqlite3 zu und schreibt den Pfad der Datenbankdatei in [DatabaseSettings] Database der Legacy-site.ini. Vor dieser Korrektur brach die Bridge mit „Could not map database driver“ ab. Siehe SQLite für die Plattform.

Was sich im Lauf der Zeit geändert hat

  • 2025-08: erste Exponential-Releases (v2.1.10): Der Installationsbefehl des Wrappers akzeptiert bei Installation über Composer ein in Anführungszeichen gesetztes Webverzeichnis, die Vendor-Namen wechselten zu se7enxweb.
  • 2026-02: Das Admin-Design admin3 ersetzt admin2 als Standarddesign des Siteaccess legacy_admin (v2.1.11), siehe die responsive Administrationsoberfläche.
  • 2026-03: Branch 3.x: Portierung auf Symfony 5.4 und PHP 8: neue TreeBuilder-API, Events der Symfony Contracts, RequestEvent / ResponseEvent, typisierter Config-Resolver, Twig 3, über die DI registrierte Befehle mit Konstruktor-Injektion (kein ContainerAwareCommand), Permission-Resolver-API von Platform 3.
  • 2026-04: Branch 4.x: Service-Aliase von Ibexa 4.6, Session-Verwaltung für Symfony 5.3+ (Factory-basierte Sitzungen), SQLite, Umbenennung der Befehle, zusätzliche Oberflächenelemente für legacy_admin über die Extension ngsite.

Grenzen

  • Das Upstream-Projekt gab an, dass die Bridge auf eZ Platform 3.x nicht unterstützt wird, weil das Schema vom Legacy-Schema abweichen würde. Die Branches von se7enxweb behalten das Legacy-Schema für die oben genannten Plattform-Kernel bei; verwenden Sie den Branch, der zu Ihrer Plattform passt.
  • Das Änderungsverzeichnis des Repositorys erfasst den ausgecheckten Branch (4.x); die Branches 3.x und 5.x tragen eigene Tags.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x