Sulu 3.0: Sechs Bundles machen Ihr Upgrade jetzt realistisch

Sulu 3.0 selbst ist seit November 2025 verfügbar, mit einer fundamentalen Umstellung von PHPCR auf Doctrine ORM als Content-Storage. Für viele reale Projekte war das Kern-Release trotzdem kein praktischer Upgrade-Kandidat, weil zentrale Ökosystem-Bundles noch nicht mitgezogen waren. Am 7. Juli hat das Sulu-Team das geändert: Form, Headless, Community, Redirect, Automation und Comment sind jetzt in stabilen 3.0-Versionen verfügbar.

Wie ich in meinem Artikel zur Sulu-3.0-Architektur beschrieben habe, ersetzt die neue Version das PHPCR-Storage durch Doctrine ORM, den Document Manager durch ein dimensionsbasiertes Content-Modell und MassiveSearch durch die SEAL-Abstraktion. Dieser Artikel setzt dort an, wo der praktische Engpass lag: den Bundles, auf die reale Projekte angewiesen sind.

Die sechs Bundle-Releases im Überblick

Warum das Headless-Bundle den größten Umbau brauchte

Das Headless-Bundle war architektonisch am stärksten von der Content-Storage-Umstellung betroffen, weil es Content-Resolver und Serializer direkt an das alte Document-Manager-Modell gekoppelt hatte. Für 3.0 mussten beide Komponenten auf das neue Doctrine-ORM-Content-Modell angepasst werden, und der Such-Endpunkt läuft jetzt über SEAL statt über MassiveSearch.

// Headless-API: Breaking Changes in der Response-Struktur
// Vorher (2.6): indices-Parameter, verschachtelte Struktur
GET /api/search?indices=pages,articles

// Jetzt (3.0): index-Parameter (Singular), flache Liste
GET /api/search?index=pages,articles

// Jeder Treffer enthält jetzt ein serialisiertes Media-Objekt
// zusätzlich zu resourceKey und id

Weitere Breaking Changes betreffen Smart Content, das jetzt eine groups-Option unterstützt, den Excerpt, der ein einzelnes image-Objekt statt eines Arrays liefert, um mit dem Sulu-Core-Format übereinzustimmen, und Navigation-Items, die jetzt einen linkType mitführen. Die mitgelieferte Referenz-JavaScript-Implementierung wurde entfernt.

Was beim Form-Bundle anders läuft

Warum bleibt das Form-Bundle template-kompatibel?

Das Sulu-Team hat für diese Release-Runde ein explizites Ziel formuliert: so nah wie möglich am 2.6-Verhalten bleiben, damit bestehende Projekte mit minimalen Änderungen upgraden können. Beim Form-Bundle ist das sichtbar gelungen. Der Single-Form-Selection-Content-Type löst weiterhin zu einem fertig renderbaren Formular auf, sodass bestehende Templates unverändert weiterlaufen.

# Intern hat sich beim Form-Bundle einiges geändert:
# - Resource-Keys jetzt im Plural (pages, articles, snippets)
# - Doctrine-Migration aktualisiert gespeicherte Submission-Typen automatisch
# - Admin-Formular-Metadaten fallen jetzt auf die konfigurierte
#   Übersetzer-Locale zurück statt hart auf Deutsch

# Betroffen sind nur Projekte, die das Bundle direkt erweitern:
# Type-Signaturen wurden verschärft, siehe UPGRADE-3.0.md

Für die meisten Projekte bedeutet das: kein Template-Aufwand. Nur wer eigene Erweiterungen des Form-Bundles pflegt, muss die verschärften Type-Deklarationen im Upgrade-Guide durchgehen.

Was ändert sich beim Automation-Bundle?

Geplante Veröffentlichungen und Depublizierungen laufen jetzt über die Message-Bus-Architektur von Sulu 3.0. Dedizierte Handler für Pages, Articles und Snippets ersetzen den bisherigen generischen Document-Handler, was Automatisierung pro Content-Typ individuell ermöglicht. Die zugrunde liegende php-task-Bibliothek wurde auf Version 3 angehoben, und gespeicherte Tasks referenzieren die Task-Entity jetzt direkt statt über eine ID.

Für Projekte mit angepasstem Task-Handling sind die entfernten Handler-Klassen und die geänderte Task-Entity Breaking Changes, die im Upgrade-Guide dokumentiert sind. Ein kleiner, aber praktischer Nebeneffekt: Die Automation-Ansicht im Admin zeigt jetzt für jede Artikel-Gruppe einen korrekt benannten Tab, statt wie vorher nur den Namen der letzten Gruppe.

Was sich bei Community, Redirect und Comment ändert

Diese drei Bundles fokussieren sich überwiegend auf die reine 3.0-Kompatibilität, mit einigen gezielten Verbesserungen. Das Community-Bundle bekommt konfigurierbare Registrierungsregeln zur Steuerung von Anmeldungen, liefert bei ungültigen Formular-Einreichungen jetzt einen korrekten HTTP-422-Status und setzt Symfony Mailer statt des veralteten SwiftMailer voraus.

Das Redirect-Bundle ersetzt ramsey/uuid durch symfony/uid und verschiebt seinen Import-Endpunkt unter den neuen Admin-API-Pfad. Das Comment-Bundle löst die veralteten Parameter page und pageSize durch limit und offset ab. Alle drei Bundles verlieren ihre PHPCR- und FOSRest-Abhängigkeiten, die sie nicht mehr benötigen.

Wichtig für Projekte, die noch nicht wechseln können oder wollen: Jedes Bundle behält eine eigenständige 2.x-Linie kompatibel zu Sulu 2.6. Diese wird weiterhin gepflegt, etwa mit Symfony-7-Support, dem Entfernen von End-of-Life-PHP-Versionen und der Migration des REST-Routings auf Symfony-Routing.

Zusammenfassung

Sechs Sulu-Bundles sind jetzt in stabilen 3.0-Versionen verfügbar: Form, Headless, Community, Redirect, Automation und Comment. Das Sulu-Team hat sich am 2.6-Verhalten orientiert, um bestehende Projekte mit minimalem Aufwand upgradebar zu machen.

Headless hat den größten Umbau erfahren, mit Breaking Changes in der API-Response-Struktur. Jeder Client muss angepasst werden.

Form bleibt weitgehend template-kompatibel, die meisten Projekte kommen ohne Template-Arbeit aus.

Community, Redirect und Comment fokussieren auf reine Kompatibilität mit kleineren gezielten Verbesserungen und verlieren ihre PHPCR- und FOSRest-Abhängigkeiten.

Sulu 2.6 bleibt als LTS-Linie verfügbar für Projekte, die noch nicht wechseln.