Tag: Symfony

1. API Platform OpenAPI Dokumentation anpassen

   03.09.2025

   Die automatisch generierte OpenAPI Dokumentation von API Platform ist ein starker Ausgangspunkt, bleibt aber ohne Nacharbeit oft zu technisch für externe Konsumenten. Eigene Summaries, konkrete Beispiele und korrekt dokumentierte Sicherheitsschemas verwandeln die generische Swagger UI Seite in eine Dokumentation, mit der ein fremdes Team tatsächlich ohne Rückfragen arbeiten kann.

   Read more

2. Contract Testing für Symfony APIs: Breaking Changes vor dem Deployment erkennen

   19.08.2025

   Ein grüner End-to-End-Test beweist nicht, dass alle Consumer einer Symfony API weiterhin funktionieren, wenn sich ein Response-Feld ändert. Contract Testing macht die Erwartungen jedes Consumers explizit und prüft sie automatisch gegen den echten Provider, lange bevor ein Breaking Change in Produktion Schaden anrichtet.

   Read more

3. API Platform: Verschachtelte Ressourcen und Subresources modellieren

   17.08.2025

   Verschachtelte Ressourcen wie Bestellpositionen unter einer Bestellung wirken auf den ersten Blick intuitiv, führen aber schnell zu unübersichtlichen URL Strukturen und doppelter Autorisierungslogik, wenn sie unüberlegt eingesetzt werden. Dieser Artikel zeigt, wie man Subresources in API Platform sauber über uriTemplate modelliert und wann eine eigenständige Ressource die bessere Wahl ist.

   Read more

4. MapQueryString und MapRequestPayload: Request Mapping in Symfony 7

   17.08.2025

   Wer in Symfony-Controllern noch manuell $request->query->get() und json_decode($request->getContent()) schreibt, verschenkt Typsicherheit und Validierung. MapQueryString und MapRequestPayload mappen Query-Parameter und Request-Body seit Symfony 6.3 direkt in typisierte DTOs — automatisch deserialisiert, validiert und einsatzbereit.

   Read more

5. Symfony Bundle von Grund auf erstellen: Eigene wiederverwendbare Komponenten bauen

   17.08.2025

   Wer denselben Code in mehreren Symfony-Projekten wiederholt, sollte ein eigenes Symfony Bundle bauen. Dieser Artikel zeigt die vollstaendige Verzeichnisstruktur, die Bundle-Klasse, das Composer-Paket und die Registrierung im Kernel, damit aus wiederkehrender Logik eine gepflegte, testbare Komponente wird.

   Read more

6. Symfony Rate Limiter: APIs vor Missbrauch schützen

   06.08.2025

   Eine öffentlich erreichbare API ohne Ratenbegrenzung ist eine offene Einladung für Brute-Force-Angriffe, Credential Stuffing und automatisierte Datenabfragen. Der Symfony Rate Limiter bietet drei verschiedene Algorithmen – Token Bucket, Sliding Window und Fixed Window – und lässt sich in Minuten in jeden Controller, Service oder Event-Listener integrieren.

   Read more

7. Symfony Mercure: Echtzeit-Updates im Browser ohne Polling

   01.08.2025

   Wer Live-Bestellstatus, Benachrichtigungen oder Chat-Nachrichten im Browser anzeigen will, denkt oft sofort an WebSockets — mit allem was dazugehört: eigener Server, Verbindungsmanagement, Protokoll-Handling. Symfony Mercure und Server-Sent Events lösen 80 % dieser Anwendungsfälle einfacher, mit weniger Infrastruktur und nativem Browser-Support ohne externe Bibliotheken.

   Read more

8. Symfony Bundles projektübergreifend teilen: Composer, Private Packagist und Satis

   26.07.2025

   Sobald ein internes Symfony Bundle in mehr als einem Repository gebraucht wird, stellt sich die Frage nach dem richtigen Verteilweg. Dieser Artikel vergleicht Private Packagist, ein selbst gehostetes Satis und Monorepo-Strategien, inklusive Composer-Konfiguration und CI-Absicherung, damit Bundles zuverlaessig und versioniert in mehreren Projekten ankommen.

   Read more

9. Symfony Webhooks: Externe Ereignisse typsicher verarbeiten

   19.07.2025

   Webhooks von Stripe, GitHub, Shopify oder eigenen Diensten kommen als HTTP-POST-Requests an – ohne Typsicherheit, ohne Schema-Garantien und potenziell von gefälschten Absendern. Symfony bietet mit dem Webhook-Component, Messenger und HMAC-Signaturprüfung eine vollständige Infrastruktur, um externe Ereignisse sicher, typsicher und asynchron zu verarbeiten.

   Read more

10. Embeddables und Value Objects in Doctrine

    17.07.2025

    Primitive Obsession, also das Abbilden fachlicher Konzepte durch nackte Strings und Integer, ist eine der häufigsten Ursachen für unklaren Domänencode. Embeddables machen Value Objects wie Money oder Address zu erstklassigen Bürgern im Doctrine-Mapping, ohne eigene Datenbanktabellen zu benötigen.

    Read more