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

Spezifikation: das Legacy-Bridge-Bundle

Diese Seite ist die Referenz für die Legacy-Bridge, das Symfony-Bundle, das den Kernel von Exponential 6 innerhalb einer Plattform-Anfrage ausführt: sein Aufbau, die Ereignisse, auf die Sie hören können, die…

Download as PDF

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

On this page

This page is a translation. Read the English original

Spezifikation: das Legacy-Bridge-Bundle

Diese Seite ist die Referenz für die Legacy-Bridge, das Symfony-Bundle, das den Kernel von Exponential 6 innerhalb einer Plattform-Anfrage ausführt: sein Aufbau, die Ereignisse, auf die Sie hören können, die Einstellungen, die es von der Plattform in den Legacy-Kernel überträgt, sein Konfigurationsbaum und seine Branches. Lesen Sie sie, wenn Sie ein Projekt konfigurieren oder erweitern, das beide Kernel ausführt. Eine Schritt-für-Schritt-Einrichtung finden Sie unter Legacy-Bridge: Exponential 6 innerhalb der Symfony-Plattform ausführen.

ElementWert
Paketse7enxweb/legacy-bridge (Repository legacyBridge)
Bundle-KlasseeZ\Bundle\EzPublishLegacyBundle\EzPublishLegacyBundle
Wurzel der Konfigurationez_publish_legacy

Was die Bridge tut

Sie startet den Kernel von Exponential 6 innerhalb einer Symfony-Anfrage, teilt Datenbank, Siteaccess, Benutzer und Caches mit dem Plattform-Kernel und lässt jeden Kernel die URLs bearbeiten, die ihm gehören.

Aufbau des Bundles

PfadZuständigkeit
bundle/DependencyInjection/Konfigurationsbaum (ez_publish_legacy), Behandlung der Geltungsbereiche, Laden der Services aus bundle/Resources/config/*.yml
bundle/LegacyMapper/Configuration, LegacyBundles, Security, Session, SiteAccess: übertragen den Zustand der Plattform in die Einstellungen des Legacy-Kernels, bevor dieser aufgebaut wird
bundle/Controller/LegacyKernelController (führt eine Legacy-Anfrage aus), LegacyRestController, LegacySetupController (Setup-Assistent), LegacyTreeMenuController, PreviewController, WebsiteToolbarController
bundle/EventListener/ConfigScopeListener, CsrfTokenResponseListener, IndexRequestListener, LegacyKernelListener, RequestListener, RestListener, SetupListener
bundle/Command/die sechs Befehle exponential:legacy:* (Namen)
bundle/Cache/Leeren des Persistenz-Caches, wenn der Legacy-View-Cache geleert wird
bundle/LegacyBundles/, bundle/Composer/Installation von Legacy-Extensions, die Symfony-Bundles definieren; Composer-Skripte
bundle/FieldType/, bundle/Rest/, bundle/Routing/, bundle/Security/, bundle/SetupWizard/, bundle/Collector/Unterstützung des Feldtyps XML-Text, REST-Brücke, Legacy-bewusstes Routing, Behandlung der Anmeldung, Einbindung des Setup-Assistenten, Datensammler für die Debug-Toolbar
mvc/Aufbau des Kernels (Kernel, LegacyEvents, LegacyKernelAware), Ereignisklassen, Adapter für Bilder, Sitzungen, Sicherheit und Signal-Slots

Ereignisse

Konstanten von LegacyEvents. Ein Listener darf die Legacy-Einstellungen ändern, während der Kernel aufgebaut wird:

KonstanteEreignisnameWann
PRE_BUILD_LEGACY_KERNEL_WEBezpublish_legacy.build_kernel_web_handlerbevor der Web-Handler aufgebaut wird
PRE_BUILD_LEGACY_KERNELezpublish_legacy.build_kernelbevor der Kernel aufgebaut wird; hier hört der Configuration-Mapper der Bridge (Priorität 128)
POST_BUILD_LEGACY_KERNELezpublish_legacy.post_build_kernelnachdem der Kernel aufgebaut ist
PRE_RESET_LEGACY_KERNELezpublish_legacy.pre_reset_legacy_kernelbevor der Kernel zurückgesetzt wird

Von der Plattform in den Legacy-Kernel übertragene Einstellungen

Der Configuration-Mapper (wenn die Bridge eingeschaltet ist) setzt diese Werte als Legacy-INI-Overrides, bevor der Kernel startet.

Legacy-EinstellungQuelle
site.ini/DatabaseSettings/Server, Port, User, Password, Database, SocketDoctrine-Verbindungsparameter host, port, user, password, dbname, unix_socket (Socket ist disabled, wenn kein Socket gesetzt ist)
site.ini/DatabaseSettings/DatabaseImplementationDoctrine-Treiber über die Zuordnung unten
site.ini/DatabaseSettings/Database (SQLite)Doctrine-Parameter path, seit v4.0.0.1
site.ini/FileSettings/VarDir, StorageDirPlattformparameter var_dir, storage_dir
site.ini/UserSettings/AnonymousUserIDPlattformparameter anonymous_user_id
site.ini/ContentSettings/ViewCachingfest auf enabled gesetzt
site.ini/SiteAccessSettings/PathPrefix, PathPrefixExcludeWurzelort und Pfadpräfix des Siteaccess
site.ini/SiteSettings/IndexPage, DefaultPagekonfigurierte Werte, sonst /content/view/full/<root location id>/
image.ini/ImageMagick/*ImageMagick-Optionen und -Filter der Plattform
file.ini/ClusteringSettings/FileHandler und eZDFSClusteringSettings/*DFS-Clustering-Parameter, wenn DFS konfiguriert ist

Treiberzuordnung (LegacyMapper\Configuration):

Doctrine-TreiberLegacy-DatabaseImplementation
pdo_mysqlezmysqli
pdo_pgsqlezpostgresql
oci8ezoracle
pdo_sqlitesqlite3 (hinzugefügt in v4.0.0.1, 2026-04-07)

Jeder andere Treiber löst eine RuntimeException aus: „Could not map database driver to Legacy Stack database implementation.“

Konfigurationsbaum

Wurzel ez_publish_legacy, in einer Konfigurationsdatei der Plattform wie config/packages/ezplatform.yaml oder app/config/ezplatform.yml:

SchlüsselTypStandardGeltungsbereichBedeutung
enabledbooltrueglobalschaltet die Bridge ein oder aus
clear_all_spi_cache_on_symfony_clear_cachebooltrueglobalcache:clear leert auch den Persistenz-Cache
clear_all_spi_cache_from_legacybooltrueglobaldas Leeren des Legacy-Inhalts-View-Caches leert den Persistenz-Cache
root_dirstringkeinerglobalLegacy-Wurzelverzeichnis; die Validierung schlägt fehl, wenn der Pfad nicht existiert
legacy_aware_routesListe von Strings[]globalRouten oder Routenpräfixe, die noch erreichbar sind, wenn legacy_mode true ist
templating.view_layoutstringkeinerSiteaccessTwig-Pagelayout, das verwendet wird, wenn eine Inhaltsansicht in Legacy gerendert wird
templating.module_layoutstringkeinerSiteaccessTwig-Pagelayout für Legacy-Module
legacy_modeboolkeinerSiteaccessder Legacy-Kernel bearbeitet die URL-Aliase des Siteaccess

Beispiel für den Siteaccess legacy_admin:

ez_publish_legacy:
    clear_all_spi_cache_from_legacy: true
    legacy_aware_routes: [ 'my_legacy_route_' ]
    system:
        legacy_admin:
            legacy_mode: true

Branches und Anforderungen

BranchphpWichtigste Anforderungen (aus composer.json)
3.x^8.0se7enxweb/exponential ^6.0.12, se7enxweb/ezpublish-legacy-installer ^2.0.4, ezsystems/ezplatform-kernel ~1.3, se7enxweb/ezplatform-xmltext-fieldtype ^2.0, symfony/framework-bundle ^5.4, se7enxweb/ngsymfonytools ^4.0, se7enxweb/richtext-datatype-bundle 2.0.x-dev
4.x^8.0wie 3.x, mit se7enxweb/exponential dev-main und se7enxweb/ezplatform-xmltext-fieldtype ^4.0
5.x^8.4se7enxweb/exponential dev-main, se7enxweb/ezplatform-xmltext-fieldtype 5.x-dev, se7enxweb/ngsymfonytools v5.0.x-dev, se7enxweb/richtext-datatype-bundle *, se7enxweb/site-bundle 5.0.x-dev, se7enxweb/site-legacy-bundle, ein Paket für den Datenbank-Übersetzer

Verwandte Bundles

  • site-legacy-bundle: Bindeglied zwischen dem neuen und dem Legacy-Kernel für Sites im Netgen-Stil (im März 2026 auf die Service-IDs von eZ Platform 3.3 portiert).
  • ngsymfonytools: Legacy-Extension mit einem Template-Operator symfony_include, um aus einer Legacy-.tpl ein Twig-Template oder eine Symfony-Unteranfrage zu rendern. Der Operator holt den Service twig aus dem Container; das funktioniert ab Symfony 5, weil der TwigPass der Bridge den Service öffentlich macht (v5.0.9, April 2026). Außerdem bringt sie einen Klassen-Alias vom alten Repository-Interface auf das von Ibexa mit.
  • ibexa-legacy-bridge (Platform 4): Portierung der Bridge auf die APIs von Ibexa 4, mit exponential:legacy:script.

Verwandte Seiten

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