Layouts auf der Plattform: der Fork von layouts-core #

Diese Seite ist für Entwickler von Nexus- und DXP-Projekten auf der Symfony-basierten Plattform, die Exponential Layouts unter PHP 8.4 oder 8.5 verwenden. Der Fork von se7enxweb des Layouts-Kerns lässt Block-Templates, die Parameter lesen, auf diesen PHP-Versionen funktionieren.

Was es ist #

Layouts ist der Seitenbaukasten der Plattformseite der Familie. Redakteure setzen eine Seite in einem visuellen Editor aus Zonen und Blöcken zusammen, und Regeln entscheiden, welches Layout für welche Anfrage gilt. Das Kernpaket enthält das Modell (Layouts, Zonen, Blöcke, Sammlungen, Regeln, Ziele, Bedingungen), das Parametersystem, die Blockdefinitionen und die Ausgabe. Nexus-Websites (siehe Nexus-Starter) bauen über die Layouts-Pakete 2.0.x darauf auf: Ibexa-Integration, Site-API-Integration, die Standardblöcke, die Layout-Administration unter /nglayouts/admin und die Editor-App unter /nglayouts/app.

Das Konzept ist dasselbe wie in Exponential Layouts, das auf den Legacy-Kernel übertragen wurde: Layout-Typen mit benannten Zonen, Blöcke mit Parametern, Sammlungen von Elementen und Regeln mit Zielen, die das Layout einer Seite auswählen. Wer das eine kennt, kennt das andere.

Verwenden #

In einem Nexus- oder DXP-Projekt installieren Sie es nicht von Hand: Das Metapaket verlangt es. In Ihrem eigenen Projekt:

composer require se7enxweb/layouts-core
composer why netgen/layouts-core     # shows se7enxweb/layouts-core as the provider

Block-Templates lesen Parameter wie gewohnt. Diese Zeile stammt aus dem Template des Galerieblocks des Nexus-Starters (templates/nglayouts/themes/app/block/gallery/sushi_bar.html.twig); es ist die Art von Zugriff, die unter PHP 8.4 ohne den Fork scheitert:

{% if block.parameter('infinite_loop').value %}data-loop="true"{% endif %}

Was der Fork ändert #

Version 2.0 des Kerns verwendet durchgehend Sprachmittel von PHP 8.4. Eines davon bricht den Zugriff aus Templates:

• PHP 8.4 führte asymmetrische Sichtbarkeit ein (private(set)). Twig liest ein Attribut eines Objekts, indem es ReflectionProperty::isInitialized() prüft, bevor es nach einer Getter-Methode sucht. Bei Eigenschaften, die mit private(set) deklariert sind, scheitert diese Prüfung, Twig erreicht den Getter nie, und eine Seite, die in einem Block-Template einen Parameter liest, bricht mit „Call to undefined method“ ab.
• Der Fork (Commit 3ec0262b2, 19.04.2026) fügt Netgen\Layouts\Parameters\Parameter ausdrückliche Getter-Methoden hinzu: getName(), getParameterDefinition(), getValue(), isEmpty() und getValueObject(), sodass Twig sie über die gewöhnliche Methodensuche auflöst. Derselbe Commit benennt das Paket in se7enxweb/layouts-core um und fügt replace: netgen/layouts-core hinzu.

Wegen der Deklaration replace wird jedes Layouts-Paket, das netgen/layouts-core verlangt, vom Fork erfüllt. Das Metapaket se7enxweb/exponential-platform-dxp verlangt den Fork direkt (Commit „require se7enxweb/layouts-core fork for PHP 8.4 private(set) Twig compatibility“, 19.04.2026). Das Tag 2.0.0-se7enx.1 kennzeichnet den Fork auf Grundlage von Upstream 2.0.0.

Was Upstream in 2.0 geändert hat (übernommene Historie) #

Zwischen Oktober 2025 und Februar 2026: Constructor Property Promotion und fehlende Typangaben (28.10.2025), Deprecations in Symfony und Doctrine entfernt (10.11.2025), PHPUnit-Annotationen durch Attribute ersetzt (11.11.2025), Werte der Kern-API auf Property Hooks umgestellt (26.11.2025), View-System und Konfigurationswerte auf Property Hooks (27./28.11.2025), UUIDs auf die Komponente Symfony Uid umgestellt (13.12.2025) und Uuid v7 in Tests (31.12.2025). Projekte, die Layout-Klassen erweitern, sollten die Upgrade-Hinweise von Upstream für 2.0 lesen, bevor sie von 1.4 wechseln.

Grenzen #

• Der Fork braucht PHP 8.4 (^8.4).
• Layouts 1.4 unter PHP unter 8.4 braucht den Fork nicht.

Verwandte Seiten #

• Exponential Layouts
• Plattformfunktionen: Administrationsoberfläche, DXP-Skeleton, Nexus-Starter, Framework-Forks für PHP 8.5, Site-Bundles, SQLite für Exponential Platform, Legacy Bridge, Datenbankverwaltung AdminNeo
• Spezifikationen: Namen der Konsolenbefehle der Plattform, Paketkarte der Plattform, SQLite-Installer der Plattform, Bundle der Legacy Bridge
• Hinweise zur Aktualisierung: Paket-Forks und Umbenennungen von Befehlen
• Changelog: Changelog der Plattform
• Chronik: Übersicht über das Ökosystem, Monate des Ökosystems, Änderungsverzeichnis