⚠️ Hinweis: Twig 3.28 legt die Administration in Shopware 6.7 lahm

Was ist passiert?
Das gestrige Twig-Release 3.28.0 (03.07.2026) hat die include()-Funktion geändert: Sie gibt nun ein Markup-Objekt statt eines Strings zurück. Die Twig-Funktion sw_include von Shopware ist mit dieser Änderung nicht kompatibel – die Administration lädt nicht mehr und endet mit einem 500-Fehler.

TwigFeaturesWithInheritanceExtension::include(): Return value must be of type string, Twig\Markup returned

Wer ist betroffen?

  • :red_circle: Shopware 6.7.6.0 – 6.7.11.1: Die Administration ist vollständig defekt, sobald twig/twig auf 3.28.0 aktualisiert wird.
  • :yellow_circle: Shopware 6.7.1.0 – 6.7.5.1: Nur betroffen, wenn ein Plugin/Theme die Funktionssyntax {{ sw_include(...) }} in seinen Templates verwendet. Der Tag {% sw_include %} ist sicher.
  • :green_circle: Shopware 6.7.0.x, 6.6 und älter: Nicht betroffen.
  • Die Storefront ist standardmäßig nicht betroffen, nur die Administration.

Betroffen seid ihr nur, wenn ihr composer update ausführt oder ein Plugin installiert, das Twig benötigt – oder bei einer Neuinstallation –, wodurch twig/twig 3.28.0 installiert wird. Wenn ihr seit dem 3. Juli kein Update durchgeführt habt, ist euer Shop in Ordnung. Führt aber bitte die untenstehenden Befehle vor eurem nächsten Update aus.

Der Web Installer und die shopware-cli fügen das neue Repository bereits automatisch hinzu, sofern es noch nicht im Projekt vorhanden ist, um einen reibungslosen Übergang zu ermöglichen.

Was ist auszuführen? :hammer_and_wrench:

composer config repositories.shopware-conflicts composer https://shopware.github.io/conflicts/
composer require shopware/conflicts

Dadurch wird die inkompatible Twig-Version blockiert und ihr seid bei zukünftigen Updates geschützt. Aufgrund der neuen Packagist-Regeln zur Versions-Unveränderlichkeit können wir diesen Schutz diesmal nicht direkt über Packagist ausliefern, daher ist das zusätzliche Repository notwendig.

Administration bereits defekt? Wird der 500-Fehler angezeigt?
Führt die beiden Befehle oben aus und stuft Twig anschließend herunter:

composer update twig/twig --with-all-dependencies

Twig wird dann wieder auf 3.27.1 aufgelöst und die Administration funktioniert erneut.

Wie geht es weiter?
Ein Patch-Release mit einem sauberen Code-Fix, der mit Twig 3.28+ kompatibel ist, wird veröffentlicht. Bis dahin sollte die neue Version vermieden werden.

Tracking-Issue: Administration crashes with 500 error on Twig 3.26+ due to TwigFeaturesWithInheritanceExtension::include() strict return type · Issue #18028 · shopware/shopware · GitHub

6 „Gefällt mir“