Anders als beim webapp-Skeleton der Symfony-Schulung nutzen wir hier die OFFIZIELLE api-platform/api-platform-Distribution – ein bereits VOLLSTÄNDIG vorkonfiguriertes Setup inklusive Docker, Datenbank und Mercure.

Voraussetzungen prüfen

Diese Distribution setzt Docker UND Docker Compose voraus (KEIN lokal installiertes PHP nötig, anders als in der Symfony-Schulung) – ALLES läuft in Containern:

docker --version
docker compose version

Das Projekt erstellen

composer create-project api-platform/api-platform aufgaben-manager-api
cd aufgaben-manager-api

Dieser Befehl lädt die KOMPLETTE Distribution herunter – inklusive vorkonfiguriertem compose.yaml, das mehrere Services bereits ENTHÄLT: den PHP/Symfony-Container (mit Caddy als Webserver), PostgreSQL, UND einen Mercure-Hub (Kapitel 67-72).

Die Container starten

docker compose up -d --wait

--wait wartet, bis ALLE Container tatsächlich "healthy" sind, bevor der Befehl zurückkehrt – nützlich, um sicherzustellen, dass die Datenbank BEREIT ist, bevor Sie im nächsten Schritt Migrationen ausführen.

docker compose ps

Zeigt ALLE laufenden Container mit Status – erwarten Sie mindestens einen php-Container (mit Caddy), einen database-Container, und einen mercure-Container.

Den ersten Aufruf testen

curl -k https://localhost/api

Caddy richtet AUTOMATISCH ein lokales, selbstsigniertes HTTPS-Zertifikat ein – GENAU wie die Symfony CLI aus der Symfony-Schulung, nur DIESMAL vollständig innerhalb der Docker-Container statt lokal installiert.

bin/console innerhalb des Containers ausführen

docker compose exec php bin/console about

GENAU derselbe bin/console-Befehl aus der Symfony-Schulung – der Unterschied: er läuft JETZT INNERHALB des php-Containers, docker compose exec php davor ist die Docker-typische Art, einen Befehl in einem laufenden Container auszuführen.

Composer-Pakete installieren

docker compose exec php composer require --dev symfony/maker-bundle

GENAU dasselbe Prinzip – composer läuft INNERHALB des Containers, damit die installierten PHP-Erweiterungen und die PHP-Version GARANTIERT zur Laufzeitumgebung passen, unabhängig davon, welche PHP-Version (falls überhaupt) lokal auf Ihrem Rechner installiert ist.