Isometrischer Backend Würfel mit JSON Linien zu Smartphone und Monitor

Was ist das Sulu Headless Bundle?

Das Sulu Headless Bundle macht aus Sulu CMS ein API First Backend. Statt fertiger HTML Seiten liefert Sulu den Content als reines JSON aus, das ein beliebiges Frontend selbst rendert, etwa eine React, Vue oder Astro Anwendung.

So verbindest du ein bewährtes PHP CMS mit modernen JavaScript Frontends. Backend Teams arbeiten weiter mit Symfony, Frontend Teams mit ihrem Framework der Wahl. Redakteure behalten die volle Sulu Oberfläche mit Live Preview und Medienverwaltung.

Das Bundle stellt Endpunkte für Seiten Content, Navigation, Snippet Areas und Suche bereit. Mit Version 3.0.1 wurde es am stärksten von der neuen Content Architektur betroffen und entsprechend umfangreich umgebaut.

NCA und Headless Sulu: Vom Prototyp zur Production

Headless Projekte scheitern selten am CMS und oft an der Schnittstelle: uneinheitliche JSON Strukturen, fehlende Caching Strategie, Medien die nicht sauber aufgelöst werden. NCA betreibt Sulu produktiv und kennt die Resolver Logik des Headless Bundles aus der Praxis. Wir helfen Teams, die API sauber zu schneiden und das Frontend robust anzubinden.

Unsere Unterstützung reicht vom PHP Consulting für die Backend API über die Frontend Anbindung mit TypeScript bis zur CI/CD Pipeline mit automatisierten Tests. Für das anspruchsvolle 3.0 Upgrade mit seinen API Änderungen bringen wir die nötige Erfahrung mit. Grundlagen vermitteln wir in der Sulu CMS PHP Schulung.

Lass uns sprechen

Finde das passende Angebot für dein Projekt

🤖

Hey! Ich bin CodeBot. Lass uns herausfinden, wie wir dein Projekt zum Fliegen bringen.

Was soll entstehen?

Der größte Rewrite im Sulu Ökosystem

Die neue Content Architektur traf das Headless Bundle am stärksten, daher der umfangreichste interne Umbau aller sechs Bundles. Die Content Resolver und Serializer wurden an das Doctrine ORM Content Modell angepasst.

Der Suchendpunkt nutzt jetzt die SEAL Abstraktion statt MassiveSearch. Dadurch ändert sich die Antwort der Suche: Der Parameter indices heißt jetzt index, Treffer kommen als flache Liste zurück und jeder Treffer enthält ein serialisiertes Medien Objekt neben Resource Key und Id.

Weitere Änderungen betreffen Smart Content, das eine neue groups Option bekommt, den Excerpt, der jetzt ein einzelnes image Objekt statt eines Arrays liefert und damit zum Sulu Core passt, sowie Navigations Elemente, die ein linkType Feld tragen. Diese Antwort Änderungen sind Breaking Changes für bestehende API Clients, ebenso der Wegfall der mitgelieferten Referenz JavaScript Implementierung.

Bereich der API	Sulu 2.6	Sulu 3.0
Such Parameter	indices	index
Such Ergebnis	verschachtelt	flache Liste mit serialisiertem Medien Objekt
Smart Content	ohne groups	neue groups Option
Excerpt Bild	Array	einzelnes image Objekt
Navigation	ohne linkType	linkType pro Element
Referenz JS Client	mitgeliefert	entfernt

Installation und Upgrade auf 3.0

Die Installation läuft über Composer. Beim Upgrade ist wegen der geänderten API Antworten Vorsicht geboten: Passe deinen Frontend Client an die neuen Feldnamen an, bevor du 3.0 in Production nimmst.

Code:

          # Neuinstallation
composer require sulu/headless-bundle

# Upgrade auf 3.0
composer require sulu/headless-bundle:^3.0

# Cache leeren
bin/console cache:clear

Der offizielle Upgrade Guide unter github.com/sulu/SuluHeadlessBundle listet jedes geänderte Feld auf. Sichere die Umstellung mit Integrationstests ab, etwa über Symfony KernelTestCase und Functional Tests gegen die JSON Endpunkte.

Wann Headless passt und wann klassisch besser ist

Das Headless Bundle ist die richtige Wahl, wenn du Content auf mehreren Kanälen ausspielst, ein modernes JavaScript Frontend nutzen willst und Symfony Expertise im Team hast. Für Mobile Apps, Digital Signage oder Custom Anwendungen spielt es seine Stärke aus.

Für reine Content Websites ohne besondere Frontend Anforderungen ist klassisches Sulu mit Twig Templates oft die effizientere Lösung: weniger bewegliche Teile, einfacheres Caching, schnellere Umsetzung. Die Entscheidung sollte projektspezifisch fallen, und genau dabei helfen wir Teams beim Einordnen.

CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.

Erreichen Sie unsere PHP Consultant Spezialisten

Wir sind Experten für PHP und helfen Ihnen, Ihre digitalen Herausforderungen zu meistern. Unser erfahrenes Team unterstützt Sie bei PHP Updates, PHP Refactoring und berät Sie remote zu allen Fragen rund um PHP. Mit unseren vollautomatischen CI/CD Deployments und einer robusten Docker-Infrastruktur bringen wir Ihre PHP-Projekte auf das nächste Level. Vertrauen Sie auf unsere Expertise für zuverlässige und skalierbare PHP-Lösungen.

Demo Team Workshop Anrufen

Häufige Fragen zum Sulu Headless Bundle

Die wichtigsten Fragen zum Headless Bundle, zum 3.0 Rewrite und zur Anbindung deines Frontends.

Was ist das Sulu Headless Bundle 2026?

Das Sulu Headless Bundle macht Sulu CMS zu einem API First Backend. Statt fertiger HTML Seiten liefert Sulu den Content als JSON über REST Endpunkte aus. Ein beliebiges Frontend, etwa React, Vue oder Astro, rendert diese Daten selbst. Redakteure behalten die volle Sulu Oberfläche mit Live Preview.

Was ändert sich im Headless Bundle mit Sulu 3.0 2026?

Das Headless Bundle wurde am stärksten umgebaut. Content Resolver und Serializer wurden an das Doctrine ORM Modell angepasst, der Suchendpunkt läuft über SEAL statt MassiveSearch. Der Parameter indices heißt jetzt index, Treffer kommen als flache Liste und der Excerpt liefert ein einzelnes image Objekt.

Welche API Änderungen bringt Headless 3.0 2026 mit?

Die Suche gibt eine flache Trefferliste mit serialisiertem Medien Objekt zurück, Smart Content bekommt eine groups Option, der Excerpt ein einzelnes image Objekt statt eines Arrays und Navigations Elemente ein linkType Feld. Zusätzlich entfällt die mitgelieferte Referenz JavaScript Implementierung. Das sind Breaking Changes für bestehende Clients.

Muss ich mein Frontend für Headless 3.0 2026 anpassen?

Ja, wenn dein Frontend die Suche oder den Excerpt nutzt. Der Such Parameter heißt jetzt index, die Trefferstruktur ist flach und das Excerpt Bild ist ein Objekt statt eines Arrays. Passe die betroffenen Stellen an, bevor du 3.0 in Production nimmst, und sichere die Umstellung mit Tests ab.

Was ist SEAL im Headless Bundle 2026?

SEAL ist die neue Suchabstraktion, über die das Headless Bundle seine Suche abwickelt. Sie kapselt verschiedene Suchbackends hinter einer einheitlichen API und ersetzt MassiveSearch. Die sichtbarste Folge im Frontend ist die geänderte Antwortstruktur der Suche mit index Parameter und flacher Trefferliste.

Welche Frontends passen zum Sulu Headless Bundle?

Grundsätzlich jedes Framework, das JSON verarbeiten kann. In der Praxis kommen häufig React, Vue, Svelte oder Astro zum Einsatz. Da das Bundle reine Daten liefert, bist du in der Wahl frei und kannst Frontend Talente einstellen, die kein Sulu spezifisches Wissen mitbringen müssen.

Wann ist klassisches Sulu besser als Headless?

Für reine Content Websites ohne besondere Frontend Anforderungen ist klassisches Sulu mit Twig Templates oft effizienter: weniger bewegliche Teile, einfacheres Caching, schnellere Umsetzung. Headless lohnt sich, wenn du Content auf mehreren Kanälen ausspielst oder ein bestehendes JavaScript Frontend anbinden willst.

Welche Endpunkte bietet das Headless Bundle?

Das Bundle stellt Endpunkte für Seiten Content, Navigation, Snippet Areas und Suche bereit. Die Navigations Endpunkte liefern verschachtelte Menüstrukturen, in 3.0 mit zusätzlichem linkType Feld pro Element. Alle Antworten sind JSON und lassen sich direkt in deinem Frontend verarbeiten.

Kann ich das Headless Bundle mit klassischem Sulu kombinieren?

Ja. Ein hybrider Ansatz ist möglich, bei dem Teile der Seite klassisch mit Twig gerendert und andere Bereiche headless über die JSON API ausgespielt werden. So hältst du dir Optionen offen und kannst schrittweise auf einen Headless Ansatz umstellen, statt alles auf einmal umzubauen.

Hilft NCA bei Headless Projekten mit Sulu?

Ja. Wir betreiben Sulu produktiv und begleiten Teams von der API Konzeption über die Frontend Anbindung bis zum Production Deployment inklusive CI/CD Pipeline. Auch das anspruchsvolle 3.0 Upgrade mit seinen API Änderungen setzen wir mit euch um. Im kostenlosen Kennenlernen schätzen wir den Aufwand ein und rechnen minutengenau ab.