ngsymfonytools: Twig und Symfony aus Legacy-Templates #

Diese Seite ist für Entwickler einer Website im Übergang von Legacy-Templates zu Symfony. ngsymfonytools (Netgen Symfony Tools) lässt Legacy-Templates Twig-Templates einbinden und Symfony-Unteranfragen ausführen, sodass Legacy-Seiten Bausteine der Symfony- oder Ibexa-Seite wiederverwenden können.

Es funktioniert nur in einer Einrichtung mit Legacy Bridge, in der der Legacy-Kernel innerhalb einer Symfony-Anwendung läuft.

Operatoren #

doc/USAGE.md der Extension beschreibt sie alle.

Beispiel #

{symfony_include(
    'NetgenTestBundle:Test:test.html.twig',
    hash(
        'theAnswer', 42,
        'homepage', fetch( 'content', 'node', hash( 'node_id', 2 ) )
    )
)}

Parameter vom Typ eZContentObject oder eZContentObjectTreeNode werden in die API-Objekte Content und Location umgewandelt, bevor sie das Twig-Template erreichen.

Was sich im Fork geändert hat (März bis April 2026) #

• Paketname und Lizenz in composer.json sind die von se7enxweb, mit einem Abschnitt replace, damit der Fork das Original sauber ersetzt.
• symfony_include fragte den Container nach dem entfernten Dienst templating (seit Symfony 5 weg), was eine ServiceNotFoundException auslöste. Es verwendet jetzt den Dienst twig. Ein Workaround mit Twig\Environment::class wurde ausprobiert und zurückgenommen, sobald die Legacy Bridge (v5.0.9) den Dienst twig öffentlich machte.
• Ein Shim mit class_alias lädt den API-Inhaltskonverter sowohl mit der alten Schnittstelle eZ\Publish\API\Repository\Repository als auch mit Ibexa\Contracts\Core\Repository\Repository von Ibexa DXP 5.0.

Verwandte Seiten #

• Legacy Bridge
• Chronik des Repositorys und Versionshinweise (zusammen mit den Plattform-Repositorys behandelt)
• Änderungsverzeichnis
• Verhaltensänderungen der Extensions