1. Einführung
Das PDF des Dokuments finden Sie |HIER|.
Den Code des Dokuments finden Sie |HIER|.
Dieses Dokument ist ein Produkt der KI Claude von Anthropic. Es folgt auf das Dokument „Schritt-für-Schritt-Einführung in das Web-Framework [Laravel]“ (2026), das seinerseits auf die Dokumente „Schritt-für-Schritt-Einführung in das Web-Framework [Flask]“, „Schritt-für-Schritt-Einführung in das Web-Framework [Spring MVC]“, „Schritt-für-Schritt-Einführung in das Web-Framework [ASP.NET Core MVC]“ und „Schritt-für-Schritt-Einführung in das Web-Framework [NestJS]“ (2026) folgte. Dieses Dokument bleibt im [PHP]-Universum, wechselt aber das Framework:
- das Framework [Laravel] wird durch das Framework [Symfony] 8.1 ersetzt, weiterhin mit der Sprache [PHP] (Version 8.4 oder höher);
- die [Blade]-Views werden durch [Twig]-Views ersetzt, die View-Engine von [Symfony];
- die Validierung mit den Regeln von [Laravel] und den Formularanfragen ([FormRequest]) wird durch die Komponente Validator von [Symfony] (Constraints, geschrieben als [PHP]-Attribute) und durch deren Komponente Form ersetzt, die Formulare mithilfe von Klassen beschreibt;
- die Guards, Middleware und [Gate]-Komponenten von [Laravel] werden durch die Komponente Security von [Symfony] ersetzt: Firewalls, Authenticators, Rollen, Passwort-Hashing und ein Versuchsbegrenzer, ergänzt durch die Bibliothek [firebase/php-jwt] für JWT-Token;
- Middleware-Komponenten gibt es in [Symfony] dagegen nicht: Event-Listener dienen dazu, in die Verarbeitung der Anfrage einzugreifen;
- der ORM [Eloquent] wird durch [Doctrine] ersetzt, einen ORM, der auf [Symfony] aufbaut, das wiederum auf [MySQL] aufsetzt.
Das Dokument folgt eng der Struktur des Kurses zu [Laravel]: zunächst zahlreiche kleine Projekte, die jeweils auf ein einziges Konzept ausgerichtet sind, danach eine umfassende Fallstudie – eine Webanwendung zur Terminverwaltung in einer Arztpraxis – mit vollständig kommentierten Dateien. Die Beispiele tragen dieselben Nummern und behandeln dieselben Themen wie in den Kursen [Laravel], [Flask], [Spring MVC], und [ASP.NET Core MVC]: Wer einen dieser Kurse kennt, kann die Frameworks Beispiel für Beispiel vergleichen. Das ist jedoch nicht erforderlich: Dieses Dokument ist in sich abgeschlossen und setzt keine Vorkenntnisse dieser Frameworks voraus. Die einzigen Voraussetzungen sind Grundkenntnisse der Webprogrammierung (das Protokoll HTTP, die Sprache HTML) und die Grundlagen der Sprache [PHP] (Variablen, Arrays, Funktionen, Klassen). Der Kurs „Einführung in die Sprache PHP7 anhand von Beispielen“ (2019) führt für alle, die sie zuerst lernen müssen, in die Sprache selbst ein; die hier verwendeten Neuerungen von [PHP] 8 (Promoted Properties, [readonly]-Klassen, Attribute, Enumerationen, benannte Argumente, der Null-Safe-Operator usw.) werden erklärt, sobald sie zum ersten Mal auftreten.
1.1. Die Rolle von Symfony in einer Webanwendung
Eine Webanwendung wird häufig in Schichten aufgebaut, wobei jede Schicht nur mit den benachbarten Schichten kommuniziert:

- Die Web-Schicht empfängt HTTP-Anfragen vom Browser und liefert ihm HTML-Seiten zurück. Dies ist die Schicht, bei deren Entwicklung uns [Symfony] hilft;
- die Geschäftsschicht enthält die Geschäftsregeln der Anwendung (z. B. „Ein Patient darf nur einen künftigen Termin haben“). Sie weiß nichts über das Web: Sie könnte ebenso gut eine Kommandozeilenanwendung bedienen;
- die Datenzugriffsschicht (DAO-Schicht, von Data Access Object) liest aus der Datenbank und schreibt in sie. Wir verwenden [Doctrine], den zu [Symfony] gehörenden ORM (Object Relational Mapper), der Tabellenzeilen auf [PHP]-Objekte abbildet.
Die Web-Schicht selbst folgt dem Muster MVC (Model-View-Controller):
- der Controller (C) ist eine [PHP]-Klasse, deren Methoden, Actions genannt, jeweils eine bestimmte Art von Anfrage bearbeiten (zum Beispiel [GET /schedule]). Eine Action liest die Anfrageparameter, verarbeitet die Anfrage über die Geschäftsschicht und wählt anschließend die anzuzeigende View aus;
- das Modell (M) ist die Menge der Daten, die die Action an die View übergibt;
- die View (V) ist eine [Twig]-Datei (Erweiterung [.html.twig]): eine HTML-Seite, die Ausdrücke wie [{{ ... }}] und Anweisungen wie [{% if %}], [{% for %}]... enthält, die die [Twig]-Engine durch Daten des Modells ersetzt.
Ein Hinweis zur Terminologie, um Verwechslungen zu vermeiden: In [Symfony] heißen die Klassen, die Datenbanktabellen repräsentieren, Entitäten (Ordner [src/Entity]). In diesem Dokument bezeichnet der Begriff „Modell“ daher stets das View-Modell (die an eine View übergebenen Daten) oder, in Kapitel 2, das Action-Modell (die Daten, die sie empfängt). Der Begriff „Template“ bezeichnet die gemeinsame View, von der andere Seiten erben (Kapitel über Views).
Die Verarbeitung einer Anfrage folgt den nummerierten Schritten im Diagramm:
- 1: Der Browser sendet eine HTTP-Anfrage, zum Beispiel [GET /schedule?doctorId=1&day=2026-09-26];
- 2: Der Webserver empfängt die Anfrage und übergibt sie an die Anwendung [Symfony] über die Datei [public/index.php]. Während der Entwicklung ist dies der in [PHP] enthaltene Server, gestartet mit dem Befehl [php -S localhost:8000 -t public]; in der Produktion ist es ein Server wie [nginx] oder [Apache], in Verbindung mit [PHP-FPM]. Die Datei [public/index.php] übergibt die Anfrage an den Kernel (Kernel) der Anwendung, der sie durch eine Reihe von Ereignissen leitet: Beteiligt sind Klassen von [Symfony] und der Anwendung sowie Listener (Session, Sicherheit, Sprache usw.). Einer von ihnen vergleicht den angeforderten Pfad mit den Routen der Anwendung und wählt die für diese Anfrage zuständige Action aus: Dies ist das Routing;
- 3: Die Action fordert die benötigten Daten von der Geschäftsschicht an; falls nötig, wendet sich die Geschäftsschicht an die DAO-Schicht, die die Datenbank [MySQL] per SQL abfragt;
- 4: Die Action erstellt das Modell M der View und weist die Engine [Twig] an, die Seite zu erzeugen (Methode [render]);
- 5: Die von der View erzeugte HTML-Seite ist die Antwort der Action, die [Symfony] an den Browser zurückgibt.
[Symfony] ist neben [Laravel] eines der beiden großen Web-Frameworks der [PHP]-Welt. Es ist frei und quelloffen, wurde 2005 von Fabien Potencier (und der französischen Firma SensioLabs) geschaffen und läuft überall dort, wo [PHP] läuft ([Windows], [Linux], [macOS]), und [PHP] funktioniert bei fast allen Webhosting-Anbietern. [Symfony] ist in erster Linie eine Sammlung von etwa fünfzig Komponenten – eigenständigen Bibliotheken (HTTP-Anfragen und -Antworten, Routing, Konsole, Formulare, Validierung, Sicherheit usw.) –, die so angesehen sind, dass andere Projekte sie verwenden: [Laravel] selbst baut auf mehreren von ihnen auf, und Leser des vorherigen Kurses sind ihnen bereits begegnet. Das Framework [Symfony] fügt diese Komponenten mithilfe von Bundles (Integrationspaketen) und einem Service-Container zusammen, der die Objekte der Anwendung erzeugt. Im Vergleich zu [Laravel] [Symfony] trifft klare Entscheidungen: keine Fassaden oder globalen Funktionen, sondern per Dependency Injection bezogene Services; explizite Konfiguration in YAML-Dateien; [PHP]-Attribute ([#[Route]], [#[Assert\NotBlank]]...) zur Beschreibung des Codes; ein ORM, nämlich [Doctrine], der Objekte von ihrer Speicherung trennt. Es ist ein Framework, das für seine Strenge, seine Dokumentation und seine Versionierungsrichtlinie bekannt ist: alle sechs Monate eine Minor-Version, alle zwei Jahre eine Version mit „Long-Term Support“ und die Garantie, dass eine Anwendung ohne Warnungen zu veralteten Funktionen ohne Änderung auf die nächste Hauptversion umsteigen kann. [Symfony] kann Server erstellen, die JSON an einen [JavaScript]-Client liefern ([Angular], [React], [Vue.js], [Flutter]...), ebenso wie klassische Webanwendungen, bei denen der Server die HTML-Seiten erzeugt und der Browser sie lediglich anzeigt. Dieser zweite Anwendungsfall ist Gegenstand dieses Dokuments.
Eine Besonderheit von [PHP] erklärt vieles an [Symfony]: Die Anwendung wird bei jeder Anfrage neu aufgebaut und anschließend verworfen (Beispiel 01). [Symfony] gleicht diesen Aufwand aus, indem es seine Konfiguration ein für alle Mal in [PHP]-Code kompiliert, der in einem Cache (Ordner [var/cache]) abgelegt wird. Darauf kommen wir häufig zurück.
1.2. Verwendete Werkzeuge
Die Beispiele wurden mit den folgenden Werkzeugen geschrieben und getestet (ihre Installation wird im Anhang beschrieben):
- [PHP] 8.4 (jede Version ab 8.4 ist geeignet), mit den Erweiterungen [intl], [mbstring], [openssl], und [pdo_mysql];
- [Composer] 2, der Bibliotheksmanager für [PHP];
- der Editor [Visual Studio Code] mit den Erweiterungen [PHP Intelephense] (Codeanalyse), [Twig Language 2] (Views) und [YAML] (Konfigurationsdateien);
- ein moderner Browser ([Chrome], [Firefox], [Edge]);
- das Kommandozeilenwerkzeug [curl], das die rohen HTTP-Antworten anzeigt (es ist in [Windows] 10 und 11 enthalten);
- ein DBMS, [MySQL] (oder [MariaDB]), zum Beispiel das von [Laragon] unter [Windows], ab dem Kapitel über den Datenzugriff und für die Fallstudie. Unter [Windows] installiert [Laragon] [PHP], [Composer], und [MySQL] in einem Zug.
[Symfony] und die übrigen Bibliotheken sind nicht Teil von [PHP]: [Composer] lädt sie bei der Installation aus dem Repository [Packagist] herunter (Sie müssen an diesem Tag also mit dem Internet verbunden sein) und legt sie in einem Ordner [vendor] ab. Jedes Projekt beschreibt seine Bibliotheken in einer Datei [composer.json]. Die folgende Tabelle listet die wichtigsten auf, zusammen mit den verwendeten Versionen:
[symfony/framework-bundle] | das Framework: Kern, Routing, Controller, Service-Container, Konfiguration, Session, Cache; es installiert die benötigten Komponenten ([symfony/http-foundation], [symfony/http-kernel], [symfony/routing], [symfony/dependency-injection]...) | 8.1.7 |
[symfony/twig-bundle], [twig/twig] | die [Twig] -Views (Kapitel über Views) | 8.1.7, 3.30.0 |
[symfony/validator], [symfony/form] | Validierung (ab Beispiel 08) und Formulare (ab Beispiel 17) | 8.1.7 |
[symfony/security-bundle] | Authentifizierung und Autorisierung (Kapitel Sicherheit) | 8.1.7 |
[symfony/translation] | Übersetzungen (Beispiele 09 und 22) | 8.1.7 |
[doctrine/orm], [doctrine/dbal], [doctrine/doctrine-bundle] | Datenbankzugriff (Beispiel 28 und Fallstudie) | 3.7.2, 4.5.0, 3.3.2 |
[firebase/php-jwt] | JWT-Token (Kapitel Authentifizierung) | 7.2.0 |
[Symfony] wird üblicherweise installiert, indem ein vollständiges Projekt mit dem folgenden Befehl erstellt wird:
oder mit dem Kommandozeilenwerkzeug von [Symfony] (dem Programm [symfony]; siehe Anhänge): [symfony new my-project --webapp]. [Composer] lädt dann das Skeleton einer [Symfony]-Anwendung herunter, anschließend deren Bibliotheken. Das Skeleton enthält außerdem [Symfony Flex], ein Plugin für [Composer], das jedes Mal, wenn eine Bibliothek ([composer require twig]) installiert wird, deren eigene Konfigurationsdateien anhand online veröffentlichter Vorlagen schreibt. So beginnt man ein echtes Projekt. Zu Lernzwecken hat dieses Vorgehen einen Nachteil: Die Dateien erscheinen von selbst, ohne dass Sie wissen, wozu sie dienen. Die Beispiele in diesem Dokument beginnen daher am anderen Ende: Beispiel 01 ist die kleinstmögliche [Symfony]-Anwendung, und jedes Beispiel fügt nur die Dateien hinzu, die es benötigt, von Hand geschrieben und kommentiert. Die Fallstudie am Ende folgt der Struktur einer üblichen [Symfony]-Anwendung.
1.3. Die Fallstudie ausführen
1.3.1. Laragon installieren
Die Fallstudie benötigt ein DBMS, MySQL, einen PHP-Interpreter sowie PHP und das Paketinstallationsprogramm [composer]. Laragon kann all das und mehr bereitstellen. Im September 2026 ist Laragon unter der URL [Download Laragon – Fast & Modern Dev Environment ] verfügbar. Laragon bringt Werkzeuge mit, mit denen sich ein PHP-Server, das DBMS und [MySQL] installieren lassen:

- in [1] ein Apache-Webserver;
- in [2] das DBMS und [MySQL];
- in [3] ein Nachrichtenwerkzeug, das wir nicht verwenden werden;
- [4] startet alle Dienste (Apache, [MySQL], MailPit);
- [5] zeigt die Webseite der URL [http://localhost] an. Standardmäßig verweist diese URL auf den Ordner <laragon-install>\www, wobei <laragon-install> der Installationsordner von Laragon ist;
- in [6] wird das Werkzeug HeidiSQL gestartet, mit dem sich MySQL-Datenbanken verwalten lassen. Wir verwenden dieses Werkzeug, um die von der Fallstudie genutzte Datenbank zu erstellen;
- in [7] wird ein Terminal geöffnet; alle für Laragon nötigen Binärdateien befinden sich im PATH;
- in [8] wird ein Windows-Explorer-Fenster im Ordner geöffnet, der zur URL [http://localhost] gehört;
Der Installationsordner von Laragon enthält die folgenden Elemente:
![]() |
- In [1] enthält der Ordner [bin] zahlreiche Anwendungen:
![]() |
- In [1] der Apache-Webserver;
- in [2] ein Kommandozeilenterminal;
- in [3] ein [git]-Client, mit dem Sie verschiedene Versionen eines Projekts verwalten können;
- in [4] ein Datenbankmanager;
- in [5] ein Mailmanager;
- in [6] das DBMS und [MySQL];
- [7], ein weiterer Webserver;
- in [8] [node.js] zum Ausführen von JavaScript-Skripten;
- [9], ein Texteditor;
- [10], der PHP-Interpreter;
- [11], der [Python]-Interpreter;
- [12], ein Cache-Server;
Laragon liefert eine umfassende Entwicklungsumgebung mit. In diesem Kurs verwenden wir:
- das DBMS, [MySQL], [6], und das Werkzeug [heidisql] für die grafische Verwaltung;
- den PHP-8.5-Interpreter;
- das Paketinstallationsprogramm [composer];
Die README der Fallstudie gibt an, dass Sie in einem Terminal die folgenden Befehle eingeben müssen:
um die für die Beispiele und die Fallstudie erforderlichen PHP-Pakete zu installieren.
um entweder eines der Beispiele oder die Fallstudie auszuführen. Wenn Sie ein [PowerShell]-Terminal in VSCode verwenden, stoßen Sie auf das folgende Problem: Weder [composer] noch [php] befinden sich nach der Installation von Laragon im PATH des Windows-Rechners. Diese Befehle werden daher in einem VSCode-Terminal nicht erkannt.
Um [composer] und [php] in den PATH des Windows-Rechners aufzunehmen, öffnen Sie ein PowerShell-Terminal im Modus [administrator] und geben dann die folgenden Befehle ein:
[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\laragon\bin\composer","Machine")
[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\laragon\bin\php\php-8.5.11-nts-Win32-vs17-x64","Machine")
Passen Sie die beiden hervorgehobenen Pfade an Ihre Umgebung an.
Sie müssen VSCode neu starten, damit diese Änderungen wirksam werden.
Um die für die Fallstudie erforderliche [MySQL]-Datenbank zu erstellen, gehen Sie wie folgt vor:
![]() |
- In [1] müssen alle Dienste gestartet sein;
- in [2] ermöglicht die Option [Database] die Verwaltung der Datenbank;
Die Option [Database] startet ein Hilfsprogramm namens HeidiSQL:
![]() |
- In [1] können Sie verschiedene DBMS-Optionen auswählen. Der vorgegebene Wert ist das DBMS MySQL. Das ist in Ordnung;
- in [2] melden Sie sich bei HeidiSQL an;
![]() | ![]() |
- Führen Sie in [1-2] die SQL-Datei aus und wählen Sie dann die Datei [dbrdvmedecins2.sql] aus, die Sie im Ordner [symfony-sept-2026/rdvmedecins2-symfony/database] finden:

Das Ausführen der Datei [3] erstellt die von der Fallstudie genutzte Datenbank [dbrdvmedecins2]. Um sie anzuzeigen, drücken Sie in HeidiSQL F5, um die Anzeige zu aktualisieren:
Anmerkung der Redaktion: Die folgenden Screenshots zeigen eine Datenbank namens [dbrdvmedecins], während die Datenbank der Fallstudie [dbrdvmedecins2] heißt. Die beiden Datenbanken sind nahezu identisch, daher hielten wir neue Screenshots für unnötig.
Ende der Anmerkung

Die Datenbank [dbrdvmedecins] wurde erstellt. Ihr Inhalt:

- in [1-3] die Tabelle [clients];
- [id] ist der Primärschlüssel der Tabelle;
- [version] ist die Versionsnummer der Zeile. Diese Nummer wird bei jeder Änderung der Zeile erhöht;
- [titre, nom, prenom] identifizieren die Person;

- in [1-3] die Tabelle [medecins];
- [id] ist der Primärschlüssel der Tabelle;
- [version] ist die Versionsnummer der Zeile;
- [titre, nom, prenom] identifizieren die Person;

- In [1-3] die Tabelle der Terminzeitfenster der Ärzte:
- [id]: Primärschlüssel;
- [version]: Versionsnummer der Zeile;
- [id-medecin]: Fremdschlüssel, der auf den Primärschlüssel des Arztes verweist;
- [hdebut, mdebut]: Stunde und Minuten des Terminbeginns. So bedeutet [8,20] 8:20 Uhr.
- [hfin, mfin]: Stunde und Minuten des Endes der Sprechstunde.

- In [1-3] die Tabelle [rv] der vereinbarten Termine;
- [id]: Primärschlüssel;
- [version]: Versionsnummer;
- [jour]: Datum des Termins;
- [id_creneau]: Fremdschlüssel, der auf den Primärschlüssel des Terminzeitfensters verweist. Da ein Zeitfenster mit einem Arzt verknüpft ist, wissen wir, welcher Arzt diesen Termin wahrnimmt;
- [id_client]: Fremdschlüssel auf die Nummer (den Primärschlüssel) des Patienten, der zum Termin kommt;

- in [1-3] listet die Tabelle [users] die Benutzer auf, die die Anwendung RdvMedecins nutzen dürfen;
- [id, version]: Primärschlüssel, Versionsnummer;
- [login, password]: Zugangsdaten des Benutzers;
- [nom]: Name des Benutzers;
- [role]: die Rolle des Benutzers. [ADMIN] hat uneingeschränkte Zugriffsrechte. [USER] hat nur Lesezugriff. Dieser Benutzer kann den Terminkalender eines Arztes einsehen, aber keinen Termin vereinbaren oder absagen;
1.3.2. Die Fallstudie ausführen
Anmerkung des Korrektors: Ich rate dem Leser, die Fallstudie sofort wie unten beschrieben auszuführen. Sobald Sie den Zweck dieser Anwendung zur Terminverwaltung vollständig verstanden haben, bitten Sie Ihre bevorzugte KI, die Anwendung wie folgt zu ändern: Von nun an kann jeder Arzt:
- seine eigenen Terminzeitfenster zwischen zwei Daten festlegen. So kann er seinen Terminkalender nach Bedarf anpassen;
- bestimmte Zeitfenster für einen bestimmten Tag aus dem Kalender entfernen – zum Beispiel, wenn er aus persönlichen Gründen nicht verfügbar ist;
Die Änderung ist nicht trivial, da sie eine Änderung der Datenbankstruktur erfordert. Bitten Sie die KI, Ihnen den neuen Anwendungscode und das SQL-Skript zur Erstellung der neuen Datenbank zu liefern. Dazu müssen Sie ihr die ZIP-Datei mit dem vollständigen Projekt sowie das SQL-Skript der alten Datenbank übergeben.
Außerdem habe ich den von Claude erstellten Kurs nicht durchgesehen. Er hatte bereits die Kurse [NestJS], [ASP.NET Core MVC], [Spring MVC] und [Flask] erstellt, die allesamt perfekt waren. Ich bin davon ausgegangen, dass das auch hier der Fall ist. Wenn Sie beim Verständnis auf ein Problem stoßen, ist die Lösung immer dieselbe: Bitten Sie Ihre bevorzugte KI, Ihnen zu erklären, was Sie nicht verstehen. Claude beispielsweise ist darin sehr gut. Möglicherweise müssen Sie das Beispiel, das Sie nicht verstehen, zu ihm „hochladen“.
Ende der Anmerkung.
Die Fallstudie am Ende dieses Dokuments ist eine vollständige Anwendung. Leser werden sie vermutlich in Aktion sehen wollen, bevor sie sich in die Details des Frameworks vertiefen: So führen Sie sie aus. Sie befindet sich im Ordner [rdvmedecins2-symfony], neben dem Ordner [examples]:
Sie müssen [PHP] (Version 8.4 oder höher), [Composer], [Visual Studio Code] und [MySQL] installiert haben (siehe Anhänge). Dann:
- Erstellen Sie die Datenbank [dbrdvmedecins2] , indem Sie das Skript [rdvmedecins2-symfony/database/dbrdvmedecins2.sql] ausführen. Mit [Laragon] öffnen Sie das Werkzeug [HeidiSQL] (Schaltfläche Database) und führen das Skript über das Menü File / Run SQL aus. Auf der Kommandozeile, im Ordner [rdvmedecins2-symfony]:
- Öffnen Sie den Ordner [rdvmedecins2-symfony] in [Visual Studio Code] (Menü File / Open Folder) und öffnen Sie dann ein Terminal (Menü Terminal / New Terminal);
- Installieren Sie die Bibliotheken der Anwendung: [Composer] liest die Datei [composer.json], lädt [Symfony] und die übrigen Bibliotheken herunter und legt sie im Ordner [vendor] der Anwendung ab (dauert einige Dutzend Sekunden):
- Prüfen Sie die Verbindung zur Datenbank. Die Anwendung verbindet sich mit [MySQL] auf [127.0.0.1], Port 3306, mit dem Benutzer [root] ohne Passwort (den Standardeinstellungen von [Laragon]). Wenn Ihr Konto [root] ein Passwort hat, tragen Sie es in der Datei [.env] der Anwendung in der Zeile [DATABASE_URL] ein: [mysql://root:myPassword@127.0.0.1:3306/dbrdvmedecins2...];
- Starten Sie die Anwendung:
- [PHP] zeigt an:
Der Entwicklungsserver lauscht auf dem Port 8081 des Rechners ([localhost]). Jede empfangene Anfrage wird in der Konsole protokolliert, zusammen mit Meldungen von [Symfony] (die gewählte Route, die an die Datenbank gesendeten SQL-Befehle);
- Öffnen Sie die Adresse [http://localhost:8081] in einem Browser:

- Melden Sie sich mit einem der Demokonten an, dessen Passwort mit dem Benutzernamen übereinstimmt: [admin] (Administrator), [pelissier], [tatou], [dupont] (Ärzte), [martin], [durand], [bistrou], [german] (Patienten). Außerdem müssen Sie die Zeichen aus dem Bild eingeben, in Groß- oder Kleinschreibung.
Eine [PHP] -Anwendung liest die Datenbank beim Start nicht: Ein Verbindungsfehler tritt erst auf der ersten Seite auf, die die Datenbank abfragt, also beim Verbindungsaufbau. [Symfony] zeigt dann seine detaillierte Fehlerseite an und protokolliert den Fehler in der Serverkonsole. Lautet die Meldung [SQLSTATE[HY000] [2002] Connection refused], wurde [MySQL] nicht gestartet; bei [[1045] Access denied for user 'root'@'localhost'] ist das Passwort falsch; bei [[1049] Unknown database 'dbrdvmedecins2'] wurde das SQL-Skript nicht ausgeführt; bei [could not find driver] ist die Erweiterung [pdo_mysql] von [PHP] nicht aktiviert. Zeigt die Seite [Failed opening required '.../vendor/autoload_runtime.php'] an, wurde [composer install] nicht ausgeführt; schlägt der Befehl [php -S] mit der Meldung [Failed to listen on localhost:8081 (reason: Address already in use)] fehl, wird Port 8081 bereits verwendet (zum Beispiel von einer anderen Version der Anwendung). Die Datei [README.md] der Anwendung beschreibt weitere Szenarien. Beenden Sie die Anwendung mit [Ctrl-C] im Terminal.
Die Fallstudie am Ende des Dokuments zeigt, wie die Anwendung benutzt wird, und erläutert anschließend jede ihrer Dateien.
1.4. Beispiele
Die Beispiele liegen im Ordner [examples], mit einem Unterordner pro Beispiel:
Jedes Beispiel ist eine kleine, eigenständig lauffähige Anwendung ([Symfony]). Alle Beispiele verwenden dieselben Bibliotheken, die in der Datei [examples/composer.json] beschrieben sind:
- Zeilen 6–29: Was die Beispiele voraussetzen: [PHP] 8.4 oder höher, die Erweiterungen [intl] (sprachspezifische Formatierung von Zahlen und Datumsangaben, Beispiel 16) und [pdo_mysql] (Zugriff auf [MySQL], Beispiel 28), gefolgt von den Bibliotheken in alphabetischer Reihenfolge: [Doctrine] (Beispiel 28), [firebase/php-jwt] (die JWT-Token, Beispiel 25) sowie die Komponenten und Bundles von [Symfony] , die die Beispiele verwenden. [^8.1] bedeutet „Version 8.1 oder eine neuere Version der Hauptversion 8“;
- Zeilen 30–34: Die Klassen im Namespace [Common] liegen im Ordner [common] (die PSR-4-Regel, gezeigt in Beispiel 01): Dies ist der gemeinsame Controller, der [Bootstrap] ausliefert (Beispiel 15);
- die übrigen Zeilen konfigurieren das Verhalten von [Composer]: Der Class Loader wird optimiert, Bibliotheken werden nach Namen sortiert, und es werden nur stabile Versionen akzeptiert.
Um die Beispiele auszuführen, installieren Sie zunächst ihre Bibliotheken – ein für alle Mal – in einem Terminalfenster, das im Ordner [examples] geöffnet ist:
[Composer] erstellt den Ordner [examples/vendor], der von allen 28 Beispielen gemeinsam genutzt wird, und die Datei [composer.lock], die die genau installierten Versionen festhält (siehe Fallstudie). Der Ordner [common] enthält das CSS-Framework [Bootstrap] ([common/bootstrap]) – gemeinsam genutzt von den Beispielen, die ihre Seiten formatieren (ab Beispiel 15) – und den Controller, der es ausliefert ([common/BootstrapController.php]; siehe Beispiel 15).
Fast alle Beispiele haben dieselbe Struktur – die einer üblichen [Symfony]-Anwendung, auf das Wesentliche reduziert. Zum Beispiel die aus Beispiel 13:
- [public/index.php]: der Einstiegspunkt für alle Anfragen; [src/Kernel.php]: der Kern der Anwendung; [bin/console]: das Kommandozeilenwerkzeug von [Symfony] (Beispiel 01);
- [config]: Konfiguration: die Bundles der Anwendung ([bundles.php]), die Konfiguration jedes einzelnen (Ordner [packages]), die Routen ([routes.yaml], Beispiel 02), die Services ([services.yaml], Beispiel 06);
- [src]: die Klassen der Anwendung: Controller ([src/Controller]), Modelle, Services usw.;
- [templates]: die [Twig] -Views (ab dem Kapitel über Views);
- [.env]: für das Beispiel spezifische Einstellungen (Beispiel 01); [var]: Dateien, die [Symfony] selbst schreibt (der Cache, die Session).
Um ein Beispiel auszuführen, öffnen Sie ein Terminal in seinem Ordner (in [Visual Studio Code]: Rechtsklick auf den Beispielordner, dann „Open in Integrated Terminal“ wählen) und geben ein:
Alle Beispiele lauschen auf Port 8000: Sie können nur eines gleichzeitig ausführen (oder Sie müssen den Port ändern: [php -S localhost:8001 -t public]). Beenden Sie den Server mit [Ctrl-C] im Terminal. Es ist nicht nötig, den Server nach der Änderung einer [PHP]-Datei, einer View oder der Konfiguration neu zu starten: Die Änderungen werden bei der nächsten Anfrage wirksam (Beispiel 01).
Wenn Sie den Ordner [examples] in [Visual Studio Code] öffnen, analysiert die Erweiterung [PHP Intelephense] alle Dateien, auch die von [Symfony] im Ordner [vendor]: In jeder Datei stehen Ihnen Codevervollständigung, Navigation zur Definition einer Klasse oder Methode (Taste [F12]) und Fehlermeldungen zur Verfügung. Da alle Beispiele ihre Klassen im Namespace [App] haben, kann die Erweiterung „doppelte“ Klassen melden: Das hat keine Auswirkung auf die Ausführung, da jedes Beispiel unabhängig läuft. Um diese Warnungen zu vermeiden, öffnen Sie einfach den Ordner des Beispiels selbst.
1.5. Inhalt des Dokuments
Das Dokument ist wie folgt aufgebaut:
Actions, Routing, Antworten | Von der Anfrage zur Action: Routen, Controller, Antworten, Weiterleitungen, gemeinsame Services | 01 bis 06 |
Das Action-Modell | Anfrageparameter: Binding, Konvertierung, Validierung, POST-Anfragen | 07 bis 12 |
Die View und ihr Template | [Twig], Template, Makros, Formulare in [Symfony], Validierung, PRG, CSRF-Schutz | 13 bis 21 |
Internationalisierung | Eine Anwendung auf Französisch und Englisch | 22 |
Datenbereiche | Request, Session, Cache, Cookies | 23 |
Der Lebenszyklus einer Anfrage | Kernel-Ereignisse, Argument-Resolver, Ausnahmebehandlung | 24 |
Authentifizierung und Autorisierung | Firewall, JWT-Authenticator in einem Cookie, Rollen, CAPTCHA, Versuchsbegrenzung | 25–27 |
Geschichtete Architektur und Datenzugriff | Web / Geschäft / DAO mit [Doctrine] und [MySQL] | 28 |
Fallstudie | Die Anwendung RdvMedecins, Datei für Datei erläutert | - |
Jedes Beispiel führt nur wenige neue Konzepte ein, und die Kapitel bauen aufeinander auf: Am besten lesen Sie sie der Reihe nach. Die Fallstudie wiederum greift auf alle Konzepte der vorangehenden Kapitel zurück: Wo es sinnvoll ist, verweist ihr Kommentar auf das Beispiel, in dem das Konzept eingeführt wurde. Die Anhänge beschreiben die Installation der Werkzeuge: [PHP], [Composer], [Visual Studio Code] und seiner Erweiterungen, [MySQL] zusammen mit [Laragon], [curl] und des Werkzeugs [symfony].





