Seite 7 - Mironsoft Blog

OpenAPI in Symfony mit NelmioApiDocBundle sauber aufsetzen

April 15, 2026

{ }

GET

REST API · OpenAPI · Symfony · NelmioApiDocBundle

OpenAPI in Symfony mit NelmioApiDocBundle
sauber aufsetzen — von Null bis Swagger-UI

Wer eine Symfony-REST-API ohne Dokumentation betreibt, überlässt Konsumenten und QA-Teams die mühsame Reverse-Engineering-Arbeit. NelmioApiDocBundle generiert aus PHP-Attributes und YAML-Konfiguration eine vollständige OpenAPI 3.1-Spezifikation – inklusive Swagger-UI, JWT-Security-Schemes und Response-Schemas direkt aus dem Code.

15 Min. Lesezeit NelmioApiDocBundle · PHP Attributes · OpenAPI 3.1 · JWT · Swagger-UI Symfony 6.x · 7.x · PHP 8.2+

Inhaltsverzeichnis

1. Warum NelmioApiDocBundle statt manueller YAML-Specs
2. Installation und Bundle-Konfiguration
3. OpenAPI-Attributes in Symfony-Controllern
4. Request- und Response-Schemas mit PHP-Klassen
5. Security-Schemes: JWT Bearer und API-Key konfigurieren
6. API-Gruppen und Versionierung
7. Swagger-UI produktionssicher bereitstellen
8. OpenAPI-Spec als JSON/YAML exportieren und testen
9. Konfigurationsansätze

Pagination in GraphQL: Cursor vs. Offset sauber umsetzen

April 15, 2026

{ }

type

GraphQL · Pagination · Relay · Magento · API-Design

Pagination in GraphQL:
Cursor vs. Offset sauber umsetzen

Pagination ist in GraphQL keine Kleinigkeit. Wer einfach Offset und Limit ins Schema schreibt, hat eine funktionierende Lösung – aber keine robuste. Cursor-basierte Pagination nach der Relay-Spezifikation ist aufwändiger, löst aber genau die Probleme, die Offset-Pagination bei wachsenden Datenmengen und parallelen Schreibzugriffen schafft.

12 Min. Lesezeit Relay-Cursor · pageInfo · Resolver · Magento · Vergleich GraphQL · REST-Vergleich · Produktionsbetrieb

Inhaltsverzeichnis

1. Warum Pagination in GraphQL kein trivialer Parameter ist
2. Offset-Pagination: Einfach, verständlich, limitiert
3. Cursor-Pagination und die Relay-Spezifikation
4. Schema-Design: Connection-Typen korrekt aufbauen
5. Resolver-Implementierung: Cursor erzeugen und auswerten
6. Typische Fehler und Fallstricke
7. Pagination in Magento GraphQL
8. Cursor vs. Offset im direkten Vergleich
9. Zusammenfassung

Testbare Services bauen: wo Produktionscode Tests erleichtert

April 13, 2026

@test

assert

PHPUnit · Testbarkeit · Clean Code · SOLID · Magento

Testbare Services bauen
wo Produktionscode Tests erleichtert

Die häufigste Erfahrung in PHP-Projekten: Tests sind schwierig zu schreiben, weil der Produktionscode es schwierig macht. Neue Abhängigkeiten direkt instanziiert, globaler State, zu viele Aufgaben in einer Klasse. Testbarkeit ist kein Zufallsprodukt – sie ist das Ergebnis konkreter Designentscheidungen im Produktionscode.

19 Min. Lesezeit Constructor Injection · SRP · Pure Functions · Value Objects · Interface Segregation PHPUnit 10/11 · PHP 8.4 · Magento 2.4.x

Inhaltsverzeichnis

1. Testbarkeit als Designqualität – nicht als Nacharbeit
2. Constructor Injection: die Grundlage testbarer Klassen
3. Single Responsibility: kleine Klassen, einfache Tests
4. Pure Functions: deterministische Logik ist sofort testbar
5. Value Objects: unveränderliche Daten, triviale Tests
6. Interface-Segregation: kleine Interfaces, präzise Mocks
7. Testbar vs. nicht testbar: Produktionscode

setup:di:compile im Build-Prozess: Timing, Caches und Generated Code

April 13, 2026

CI/CD

.yml

GitLab · Magento · DI Compile · Build-Prozess

setup:di:compile im Build-Prozess:
Timing, Caches und Generated Code

setup:di:compile ist einer der zeitintensivsten Schritte im Magento-Build-Prozess — und einer der am häufigsten falsch platzierten. Zu früh ausgeführt fehlt die vollständige Composer-Basis; zu spät ausgeführt verzögert es den Deploy. Dieser Artikel zeigt, wann und wie di:compile in einer GitLab-Pipeline am besten läuft.

14 Min. Lesezeit di:compile · generated/ · Artefakte · Caching · Fehlerdiagnose Magento 2.4 · PHP 8.4 · GitLab 16+

Inhaltsverzeichnis

1. Was setup:di:compile tatsächlich tut
2. Timing: wann in der Pipeline di:compile laufen muss
3. generated/ als Build-Artefakt behandeln
4. Caching-Strategien für di:compile in GitLab
5. Vollständiger Build-Job mit di:compile
6. Häufige Compile-Fehler und ihre Ursachen
7. generated/ und Zero-Downtime-Deployment
8. Vergleich: di:compile im Build vs. auf dem Server
9. Typische Fehler im Build-Prozess
10. Zusammenfassung

Database Tools in PhpStorm für MySQL und MariaDB richtig einsetzen

April 12, 2026

IDE

{ }

PhpStorm · MySQL · MariaDB · SQL · Magento 2

Database Tools in PhpStorm
für MySQL und MariaDB richtig einsetzen

PhpStorm enthält einen vollwertigen Datenbankclient, der TablePlus, phpMyAdmin oder DBeaver für die meisten Entwicklungsaufgaben ersetzt. Verbindungen einrichten, SQL mit Autovervollständigung schreiben, Schemas visualisieren und Dumps erstellen – alles ohne die IDE zu verlassen und mit direktem Kontext zur geöffneten PHP-Datei.

14 Min. Lesezeit Database Console · Schema-Diagramme · Dumps · SQL-Autovervollständigung PhpStorm 2024.x · MySQL 8.x · MariaDB 11.x

Inhaltsverzeichnis

1. Was die PhpStorm Database Tools leisten – und was nicht
2. Datenbankverbindung zu MySQL und MariaDB einrichten
3. Docker-Container als Datenbankquelle verbinden
4. SQL Console: Abfragen schreiben und ausführen
5. SQL-Autovervollständigung und Code-Intelligenz
6. Schema-Browser und Diagramme
7. Daten direkt im Tabellen-Editor bearbeiten
8. Dumps erzeugen und importieren
9. PhpStorm Database vs.

Docker Compose für lokale Entwicklungsumgebungen richtig entwerfen

April 11, 2026

Docker Compose · Entwicklungsumgebung · DevEx · Team

Docker Compose für lokale Entwicklungsumgebungen
richtig entwerfen — von Tag eins an

Eine lokale Entwicklungsumgebung mit Docker Compose ist mehr als ein gestarteter Container. Wer Bind-Mounts falsch konfiguriert, verliert Performance. Wer Secrets in der Compose-Datei hardcoded, gefährdet das Projekt. Wer kein Onboarding-Konzept hat, verliert Stunden bei jedem neuen Teammitglied. Dieser Guide zeigt, wie man es von Anfang an richtig macht.

18 Min. Lesezeit Bind-Mounts · Hot-Reload · Secrets · Override · Onboarding Docker Compose v2 · macOS · Linux · Windows (WSL2)

Inhaltsverzeichnis

1. Die richtige Philosophie für Dev-Umgebungen
2. Bind-Mounts: Performance und Konsistenz
3. Hot-Reload für Backend und Frontend
4. Secrets und Umgebungsvariablen sicher verwalten
5. Override-Dateien: Dev vs. Prod trennen
6. Lokale DNS und Netzwerkzugriff komfortabel gestalten
7. Datenbankzustand im Development sinnvoll handhaben
8. Ein-Befehl-Onboarding für

Symfony UX TwigComponent: Wiederverwendbare Blöcke bauen

April 11, 2026

We're sorry, an error has occurred while generating this content.

Teleport, Suspense und Async Components in Vue 3 sinnvoll einsetzen

April 11, 2026

We're sorry, an error has occurred while generating this content.

Alpine.js x-effect: Reaktive Seiteneffekte ohne Watcher-Boilerplate

April 11, 2026

x-data

Alpine

Alpine.js · x-effect · Reaktivität · Seiteneffekte

Alpine.js x-effect:
Reaktive Seiteneffekte ohne Watcher-Boilerplate

x-effect beobachtet reaktiven State ohne explizite Watcher-Definition. Wer verwendet wird, bestimmt Alpine automatisch – durch Ausführen des Codes und Tracking der Zugriffsreihenfolge. Das macht Synchronisation mit localStorage, externen Libraries und dem DOM außerhalb des Alpine-Scopes ausgesprochen sauber.

10 Min. Lesezeit x-effect · $watch · Alpine.effect() · Dependency Tracking · Side Effects Alpine.js 3.x · Hyvä Themes

Inhaltsverzeichnis

1. Wie x-effect intern funktioniert: Dependency Tracking
2. Die erste Ausführung: x-effect läuft sofort einmal
3. x-effect vs. $watch: Wann welches Werkzeug?
4. localStorage Synchronisation mit x-effect
5. Externe Libraries mit Alpine State synchronisieren
6. DOM-Updates außerhalb des Alpine-Scopes
7. Alpine.effect() in JavaScript verwenden
8. Typische Fallstricke: Zyklen und Performance
9. x-effect im Vergleich mit anderen

Magento

Installation of Hyvä Themes in Magento

Mir Admin - April 11, 2026

Diese Anleitung führt Sie durch die Installation des Hyvä-Themes in einem Magento-2-Shop. Sie behandelt Systemvoraussetzungen, Composer-Installation, Theme-Aktivierung und wichtige Konfigurationen nach der Installation.