sylius-agent-contracts — das Fundament, das selbst nichts ausliefert.

Ein Paket ohne Endpunkte kann auch keine kaputt machen

sylius-agent-contracts ist Abhängigkeit aller übrigen Bundles der Familie. Brächte es selbst Routen mit, würde jede Installation eines beliebigen Einzelpakets automatisch Endpunkte veröffentlichen, die niemand angefordert hat. Deshalb enthält es ausschließlich Interfaces, Registries und den Request-Kontext — was ein Shop nach außen anbietet, entscheidet allein, welche der anderen Bundles installiert sind.

Die Registrierung läuft über den Container statt über eine Konfigurationsdatei: Eine Klasse, die eines der Provider-Interfaces implementiert, wird automatisch eingesammelt — auch dann, wenn sie im eigenen App-Namespace unter App\ liegt und nicht in einem Bundle. Der Fehler, den das vermeidet, ist der unauffälligste überhaupt: Ein Provider wird geschrieben, funktioniert in seinem Unit-Test, wird aber nie eingetragen — und fehlt danach still in der Ausgabe, ohne dass irgendwo ein Fehler auftaucht.

Der Request-Kontext trägt Channel, Base-URL und Locale, und alle Cache-Keys gehen durch ihn. Das ist keine Bequemlichkeit, sondern die Trennlinie zwischen den Kanälen: Wer einen Cache-Key aus dem Dokumententyp allein bildet, liefert dem zweiten Kanal die Dokumente des ersten aus — mit dessen Base-URL, dessen Sprache und dessen Sortiment. Solche Fehler treten in einer Ein-Kanal-Entwicklungsumgebung nie auf und in der Produktion sofort.