Lernseite · PHP, PSR und HTTP

Das Fundament unter TYPO3: PHP, PSR-Standards und HTTP

Stand 15. November 2026 · TYPO3 14.3 LTS · ca. 18 Min. Lesezeit

TYPO3 steht auf einem Fundament, das nicht von TYPO3 stammt: der Sprache PHP, den gemeinsamen Standards der PHP-Welt und dem Protokoll HTTP. Hier begleitest du die Extension my_extension durch den Alltag. Sie lädt ihre Klassen automatisch, holt Sprecherdaten von einer fremden API, prüft Anfragen in einer Middleware und liefert eine CSV-Datei aus.

Standards der PHP-Welt: PSR und PER

Die PHP Framework Interop Group, kurz PHP-FIG, ist ein Zusammenschluss von PHP-Projekten. Sie veröffentlicht PSRs, also PHP Standards Recommendations. Ein PSR legt gemeinsame Schnittstellen oder Regeln fest, damit Bibliotheken verschiedener Hersteller zusammenpassen. Er ist kein Teil der Sprache PHP und kein TYPO3-Standard.

Ein PSR durchläuft die Phasen Pre-Draft, Draft und Review. Erst mit dem Status Accepted ist er verabschiedet. Ersetzte Standards tragen den Status Deprecated, aufgegebene Vorschläge heißen Abandoned.

Diese Standards begegnen dir in TYPO3 ständig:

  • PSR-3 beschreibt das Logger-Interface.
  • PSR-4 regelt das Autoloading.
  • PSR-7 beschreibt HTTP-Nachrichten, also Request und Response.
  • PSR-11 beschreibt den Container für Dependency Injection.
  • PSR-14 beschreibt den Event Dispatcher.
  • PSR-15 beschreibt Middlewares und Request Handler. Daraus baut TYPO3 die Stacks für Frontend und Backend.
  • PSR-17 beschreibt Factories, die HTTP-Nachrichten erzeugen.
  • PSR-18 beschreibt einen HTTP-Client.

Veraltet sind PSR-0 für das Autoloading und PSR-2 für den Code-Stil. TYPO3 nutzt beide nicht mehr.

Beim Code-Stil gilt heute der PER Coding Style. PER steht für PHP Evolving Recommendation. Ein PSR ist nach der Annahme eingefroren, eine PER wächst mit neuen PHP-Versionen. Der PER Coding Style erweitert und ersetzt PSR-12, das Enums, Attribute oder readonly noch nicht kennt. TYPO3 nutzt ihn über das Paket typo3/coding-standards.

PHP auf dem Server

Der Browser sieht nie PHP-Code, nur das Ergebnis. Ein Webserver wie Apache oder nginx nimmt die Anfrage an und reicht sie per FastCGI an PHP-FPM weiter, einen Pool von PHP-Prozessen. Seltener läuft PHP als Modul in Apache. Den eingebauten Server, gestartet mit php minus groß S, nutzt man nur in der Entwicklung.

PHP-Erweiterungen bringen zusätzliche Funktionen mit. TYPO3 braucht zum Beispiel intl. Sie stellt die ICU-Bibliothek bereit und formatiert Datum, Zahlen und Sortierung passend zu Sprache und Region.

  1. Schau in die Liste der Erweiterungen auf php.net. Dort steht, ob sie mit PHP gebündelt ist oder über PECL kommt.
  2. Installiere sie über die Paketverwaltung des Systems, unter Debian etwa das Paket php8.3-intl mit apt.
  3. Aktiviere sie bei Bedarf in der php.ini mit extension gleich intl und starte PHP-FPM neu.

Composer installiert keine Erweiterungen. Ein Eintrag ext-intl in der composer.json prüft nur, ob sie da ist. Welche Erweiterungen geladen sind, zeigt der Befehl php minus m, im Code phpinfo() oder extension_loaded(). Kommandozeile und Webserver laden oft verschiedene php.ini-Dateien. Prüfe deshalb beide.

Modernes PHP im Alltag

Jede PHP-Datei der Extension beginnt so:

<?php

declare(strict_types=1);
Codebeispiel. Nach dem öffnenden PHP-Tag steht declare strict_types gleich 1.

Ohne diese Zeile wandelt PHP skalare Werte still um. Ein int-Parameter nimmt dann auch den Text "5" an. Mit strict_types wirft derselbe Aufruf einen TypeError. Das gilt für Aufrufe aus dieser Datei heraus, nicht für Aufrufe aus anderen Dateien. TYPO3 verlangt die Zeile in jeder Datei.

Der Typ ?string heißt: ein Text oder null. Optional wird der Parameter dadurch nicht, dafür braucht er einen Standardwert. Ob der Text leer ist, prüft der Typ auch nicht.

Der Service ConferenceImporter bekommt seine Abhängigkeiten über den Konstruktor:

public function __construct(
    private readonly ConferenceRepository $repository,
    private readonly LoggerInterface $logger,
) {}
Codebeispiel. Der Konstruktor hat zwei Parameter mit private readonly davor: das ConferenceRepository und ein LoggerInterface. PHP legt dafür automatisch zwei Eigenschaften an.

Das ist Constructor Property Promotion. Steht eine Sichtbarkeit vor dem Parameter, legt PHP die Eigenschaft an und weist den Wert zu. readonly gibt es seit PHP 8.1. Die Eigenschaft wird einmal gesetzt, jeder weitere Schreibversuch wirft einen Fehler. Seit PHP 8.2 macht eine readonly-Klasse alle Eigenschaften readonly, praktisch für ein Wertobjekt wie Money. final verhindert dagegen nur das Erben.

Attribute gibt es seit PHP 8.0, etwa das Attribut AsEventListener über einer Klasse. PHP prüft ihre Syntax, Frameworks lesen sie per Reflection mit getAttributes(). Sie ersetzen Annotationen in Kommentaren. In TYPO3 14 sind die alten Extbase-Annotationen entfernt.

  • Enums: Die Konferenz hat einen Status mit den Fällen Draft und Published. Status::from() wirft bei unbekanntem Wert einen ValueError, Status::tryFrom() liefert null. Mit new erzeugst du kein Enum, und cases() liefert eine Liste aller Fälle.
  • match vergleicht streng, wie mit drei Gleichheitszeichen. Der Text "1" passt nicht auf die Zahl 1. Ohne Treffer und ohne default wirft match einen UnhandledMatchError. switch vergleicht locker.
  • Der Nullsafe-Operator aus Fragezeichen und Pfeil liefert null, wenn links davon null steht. Er gehört direkt hinter den Aufruf, der null liefern kann.
  • Benannte Argumente übergeben Werte über den Parameternamen. Übersprungene optionale Parameter behalten ihren Standard. Parameternamen werden so Teil der Schnittstelle.
$mailer->send('a@example.org', 'Hallo', priority: 1);
$city = $conference->getVenue()?->getCity();
$status = Status::tryFrom($value) ?? Status::Draft;
Codebeispiel. Ein Aufruf mit dem benannten Argument priority gleich 1. Dann holt der Nullsafe-Operator die Stadt nur, wenn getVenue einen Ort liefert. Zuletzt tryFrom mit Status Draft als Standard.

Zwei Fallen zum Schluss. substr() und strlen() zählen Bytes. Ein Ü belegt in UTF-8 zwei Bytes, für Überblick liefert strlen() also 10, mb_strlen() dagegen 9. Kürze mit mb_substr(), sonst zerschneidest du Zeichen. Und bei DateTimeImmutable liefert modify() ein neues Objekt, das Original bleibt gleich. Ein DateTime würde sich selbst ändern.

Namespaces und Autoloading

Ohne Namespaces dürfte es im Projekt nur eine Klasse namens PriceService geben. Mit einem Namespace wie MyVendor, MyExtension, Service ist der volle Name eindeutig. Zugleich leitet der Autoloader aus dem Namespace den Dateipfad ab. Sichtbarkeit regeln Namespaces nicht.

Ein Autoloader lädt die Datei einer Klasse erst, wenn die Klasse zum ersten Mal gebraucht wird. require-Anweisungen von Hand entfallen. PHP ruft dafür den Autoloader auf, der mit spl_autoload_register() angemeldet wurde. Pakete aktualisiert er nicht.

Nach PSR-4 gehört zu einem Namespace-Präfix ein Verzeichnis. Das steht im Abschnitt autoload der composer.json der Extension:

"autoload": {
    "psr-4": { "MyVendor\\MyExtension\\": "Classes/" }
}
Ausschnitt aus der composer.json. Unter autoload und psr-4 zeigt der Namespace MyVendor MyExtension auf das Verzeichnis Classes.
PSR-4: vom Klassennamen zur Datei MyVendor\MyExtension\ Domain\Model\Conference Präfix aus composer.json Rest des Namens Classes/ Domain/Model/Conference.php Basisordner Unterordner und Dateiname Classes/Domain/Model/Conference.php Groß- und Kleinschreibung muss exakt stimmen
PSR-4: Das Präfix wird zum Basisordner, der Rest zum Pfad.

Composer schreibt den Autoloader in die Datei vendor/autoload.php, bei composer install, composer update und composer dump-autoload. Ein eigenes Skript bindet nur diese Datei ein, in TYPO3 erledigt das der Einstiegspunkt. Die Services.yaml steuert die Dependency Injection und setzt Autoloading voraus. Seit TYPO3 14 braucht jede Extension eine composer.json, auch im Classic Mode.

Auf Produktivsystemen lohnt composer dump-autoload mit optimize oder classmap-authoritative. Composer erzeugt dann eine Classmap, eine fertige Liste von Klasse und Datei. PHP findet Klassen ohne Suche im Dateisystem. Mit classmap-authoritative sucht Composer nur noch dort, neue Klassen brauchen einen neuen Dump.

HTTP: Anfrage und Antwort

HTTP ist zustandslos. Jede Anfrage steht für sich. Zustand über mehrere Anfragen entsteht über Cookies und Sessions, in TYPO3 etwa über das Cookie fe_typo_user.

Eine Anfrage hat Methode, URL, Header und manchmal einen Body:

  • GET ruft eine Seite ab, das nutzt der Browser fast immer. GET und HEAD sind sicher, sie sollen nichts verändern.
  • POST schickt Daten, etwa aus einem Formular. POST ist weder sicher noch idempotent.
  • PUT ersetzt, DELETE löscht. Beide sind idempotent: Mehrfaches Ausführen wirkt wie einmaliges.

Die Antwort beginnt mit einem Statuscode. 200 heißt OK. 401 Unauthorized heißt, die Anmeldung fehlt oder ist ungültig. 403 Forbidden heißt angemeldet, aber ohne Berechtigung. 404 Not Found heißt, die Ressource gibt es nicht. 410 Gone heißt dauerhaft entfernt. 429 Too Many Requests meldet ein überschrittenes Anfragelimit. 500 ist ein interner Serverfehler, 503 heißt vorübergehend nicht verfügbar.

Welcher Status für welche Weiterleitung? Methode darf wechseln (POST wird oft GET) Methode bleibt POST bleibt POST dauerhaft vorüber- gehend 301 Moved Permanently 308 Permanent Redirect 302 Found 307 Temporary Redirect Suchmaschinen: 301 303 See Other: Folgeanfrage immer per GET Nach Formularen: Post, Redirect, Get
Welcher Status passt zu welcher Weiterleitung?

Zieht eine Seite für immer um, nimmst du 301, oder 308, wenn ein POST erhalten bleiben muss. Suchmaschinen übernehmen dann die neue URL. Nach einem Formular passt 303 See Other. Der Browser lädt die Danke-Seite per GET, und Neuladen schickt das Formular nicht noch einmal. Das Muster heißt Post, Redirect, Get. Auch redirect in Extbase sendet standardmäßig 303. Bei 307 würde der Browser den POST wiederholen.

Auch das Caching steuern Header. Für persönliche Daten sendest du Cache-Control mit no-store. Das verbietet jedes Speichern, im Browser und im Proxy. no-cache erlaubt das Speichern, verlangt aber vor jeder Wiederverwendung eine Rückfrage. public erlaubt sogar geteilten Caches das Speichern. Der ältere Header Expires nennt nur eine Ablaufzeit.

PSR-7: Request und Response als Objekte

PSR-7 macht aus HTTP-Nachrichten PHP-Objekte. Die gemeinsame Basis mit Headern und Body ist das MessageInterface. Ein RequestInterface beschreibt eine ausgehende Anfrage, wie sie ein HTTP-Client verschickt. Die eingehende Anfrage auf dem Server ist ein ServerRequestInterface. Es kennt zusätzlich Cookies, Server-Parameter, Query-Parameter, den geparsten Body, hochgeladene Dateien und Attribute. Dazu kommen ResponseInterface, UriInterface für die Adresse und StreamInterface für den Body.

  • getQueryParams() liefert die Parameter der URL, also die GET-Parameter.
  • getParsedBody() liefert die Formulardaten, also die POST-Daten.
  • getUploadedFiles() liefert hochgeladene Dateien.
  • getAttribute() liefert Werte, die Middlewares ergänzt haben, in TYPO3 etwa site oder frontend.user. Sie kommen nie vom Besucher.

Methoden wie getPostParams oder getSession gibt es nicht. Das globale POST-Array liest du in TYPO3 nicht direkt.

$email = $request->getParsedBody()['email'] ?? '';
$site = $request->getAttribute('site');
Codebeispiel. Das Feld email kommt aus getParsedBody, mit leerem Text als Ersatz. Die Site kommt aus dem Attribut site.

PSR-7-Nachrichten sind unveränderlich. Jede Methode, die mit with beginnt, liefert eine geänderte Kopie. Ein withHeader() ohne Zuweisung ändert also nichts, ein häufiger Fehler.

$response = $response->withHeader('X-Conference', '42');
Codebeispiel. Richtig ist, das Ergebnis von withHeader wieder der Variablen response zuzuweisen.

Die Leseposition im Body ist davon nicht betroffen. Der Body ist ein Stream mit Lesezeiger. getContents() liest ab der aktuellen Position bis zum Ende, ein zweiter Aufruf liefert also nichts. Wandelst du den Body in einen String um, spult PHP vorher zurück, und du bekommst alles. Alternativ rufst du rewind() auf.

PSR-15: Middlewares und Request Handler

PSR-15 definiert zwei Interfaces. Ein Request Handler implementiert das RequestHandlerInterface mit der Methode handle(). Sie bekommt einen ServerRequest und gibt eine Response zurück. Eine Middleware implementiert das MiddlewareInterface mit der Methode process(). Sie bekommt den Request und den nächsten Handler und gibt ebenfalls eine Response zurück.

Request Response 401 Middleware 1 Middleware 2 Request Handler erzeugt die Seite handle() Middleware 1 antwortet früh mit 401 handle() wird nicht aufgerufen, innen läuft nichts
Middlewares liegen wie Schalen einer Zwiebel um den Request Handler.

Eine Middleware hat drei Möglichkeiten:

  • Sie ergänzt den Request, etwa mit withAttribute(), und reicht ihn mit handle weiter.
  • Sie gibt selbst eine Response zurück, ohne den nächsten Handler aufzurufen.
  • Sie verändert auf dem Rückweg die Response des nächsten Handlers, etwa mit einem Header.

Eine Ausgabe per echo widerspricht dem Konzept. Die ältere Form mit __invoke(), die Request, Response und eine Funktion next bekam, hat PSR-15 bewusst nicht übernommen.

TYPO3 hat je einen Stack für Frontend und Backend. Eigene Middlewares meldest du in der Datei Configuration/RequestMiddlewares.php an.

Nachrichten erzeugen und versenden: PSR-17 und PSR-18

PSR-7 beschreibt nur die Nachrichten, nicht wie man sie erzeugt. Dafür gibt es PSR-17 mit sechs Factory-Interfaces:

  • RequestFactoryInterface und ServerRequestFactoryInterface.
  • ResponseFactoryInterface.
  • StreamFactoryInterface, UploadedFileFactoryInterface und UriFactoryInterface.

So muss dein Code keine konkrete PSR-7-Klasse kennen. PSR-17 ersetzt PSR-7 nicht und macht nichts veränderbar. In TYPO3 lässt du dir die Factories per Dependency Injection geben. Ein Controller von my_extension liefert damit eine CSV-Datei:

return $this->responseFactory->createResponse()
    ->withHeader('Content-Type', 'text/csv')
    ->withHeader('Content-Disposition', 'attachment; filename="export.csv"')
    ->withBody($this->streamFactory->createStream($csv));
Codebeispiel. Die responseFactory erzeugt eine Response. withHeader setzt den Content-Type text csv und Content-Disposition attachment mit dem Dateinamen export.csv. withBody setzt einen Stream, den die streamFactory aus dem CSV-Text erzeugt.

Content-Disposition mit attachment lässt den Browser die Datei speichern. echo mit exit umgeht die Middleware-Kette. Die PHP-Funktion header setzt Header an der Response vorbei. Eine JsonResponse würde den Text als JSON kodieren.

PSR-18 beschreibt den HTTP-Client. Das ClientInterface hat die Methode sendRequest(). Sie nimmt einen PSR-7-Request und liefert eine PSR-7-Response. Fehler meldet sie über ClientExceptionInterface, NetworkExceptionInterface und RequestExceptionInterface. Ein Status ab 400 ist dabei kein Fehler, sondern eine normale Response. Eigene Guzzle-Optionen je Anfrage erlaubt PSR-18 nicht. In TYPO3 steckt Guzzle dahinter, und die globalen Einstellungen unter HTTP gelten, etwa Proxy und Header.

Bequemer ist die Methode request() der TYPO3-Klasse RequestFactory:

$response = $this->requestFactory->request($url, 'GET', ['timeout' => 5]);
$json = (string)$response->getBody();
Codebeispiel. Der ConferenceImporter ruft die Sprecher-API per GET mit timeout 5 auf. Den Inhalt liest er, indem er den Body in einen String umwandelt.

Das Ergebnis ist eine PSR-7-Response, kein fertiges Array. Die Optionen im dritten Parameter überschreiben die globalen Werte für diesen Aufruf. Das lohnt sich, denn global ist der timeout 0, also unbegrenzt. Anders als beim reinen PSR-18-Client wirft Guzzle hier bei Status 404 oder 500 eine Exception, die du abfangen musst.

JSON und der Symfony Finder

Die Sprecher-API antwortet in JSON. JSON verlangt doppelte Anführungszeichen um Schlüssel und Texte. Es kennt Objekte, Listen, Zahlen, true, false und null. Ein Komma nach dem letzten Eintrag ist verboten, Kommentare auch.

{"name": "TYPO3", "version": 14, "lts": true, "tags": ["cms", "php"]}
Gültiges JSON: ein Objekt mit name TYPO3, version 14, lts true und einer Liste tags mit cms und php.

json_encode() wandelt ein Array in JSON um, json_decode() liest es ein. serialize() erzeugt ein PHP-eigenes Format, das andere Systeme nicht verstehen.

Bei fehlerhaftem JSON liefert json_decode() normalerweise null. Das sieht aus wie ein gültiges null, den Grund kennt nur json_last_error(). False liefert die Funktion nie. Setze deshalb JSON_THROW_ON_ERROR, dann wirft PHP eine JsonException. Der zweite Parameter ist ein Wahrheitswert für assoziative Arrays, keine Flags.

$speakers = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
$text = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
Codebeispiel. json_decode mit true für Arrays, Tiefe 512 und JSON_THROW_ON_ERROR. Danach json_encode mit zwei Flags, verbunden durch einen senkrechten Strich: JSON_PRETTY_PRINT und JSON_UNESCAPED_UNICODE.

JSON_PRETTY_PRINT rückt ein und bricht Zeilen um. Mit JSON_UNESCAPED_UNICODE bleiben Umlaute lesbar statt als Unicode-Escape. Mehrere Flags verbindest du mit einem senkrechten Strich. Noch eine Falle: array_filter() behält die Schlüssel. Ein Array mit Lücken wird in JSON zum Objekt. array_values() nummeriert neu, dann entsteht eine Liste.

Symfony ist eine Sammlung wiederverwendbarer PHP-Komponenten, ein Webframework darauf und eine Community. TYPO3 nutzt einzelne Komponenten wie Console, Dependency Injection, Routing, Mailer und Messenger, nicht das ganze Framework.

Der Symfony Finder sucht Dateien und Ordner, standardmäßig samt Unterordnern. depth() begrenzt die Tiefe, Ordner von Versionsverwaltungen ignoriert er. Filter sind etwa name() und notName(), date() für das Änderungsdatum, size() für die Größe, contains() und exclude(). Er liefert SplFileInfo-Objekte. Kopieren und Löschen übernimmt dagegen die Komponente Filesystem.

$files = Finder::create()->files()->in($dir)->name('*.xlf');
Codebeispiel. Der Finder sucht im Ordner dir samt Unterordnern alle Dateien, deren Name auf xlf endet.

Das Wichtigste in Kürze

  • PSRs sind Empfehlungen der PHP-FIG, verabschiedet heißt Accepted. Der PER Coding Style ersetzt PSR-12.
  • TYPO3 14 braucht PHP 8.2, meist als PHP-FPM hinter Apache oder nginx.
  • PSR-4 bildet ein Namespace-Präfix aus der composer.json auf einen Ordner ab.
  • 301 und 308 sind dauerhaft, 302 und 307 vorübergehend, nach 303 folgt immer GET.
  • PSR-7-Objekte sind unveränderlich. Weise das Ergebnis jeder with-Methode zu.
  • Eine Middleware hat process und darf früh antworten, ein Request Handler hat handle.
  • PSR-17 erzeugt Nachrichten, PSR-18 verschickt sie.
  • json_decode mit JSON_THROW_ON_ERROR macht Fehler sichtbar.

Begriffe

PSR
PHP Standards Recommendation, eine Empfehlung der PHP-FIG.
PER Coding Style
Fortgeschriebener Code-Stil der PHP-FIG, Nachfolger von PSR-12.
Autoloader
Lädt die Datei einer Klasse, sobald die Klasse gebraucht wird.
Classmap
Fertige Liste, die jeder Klasse ihre Datei zuordnet.
Idempotent
Mehrfaches Ausführen wirkt wie einmaliges.
Middleware
Schicht, die Request und Response bearbeitet und weiterreicht.
Factory
Objekt, das andere Objekte erzeugt, bei PSR-17 die HTTP-Nachrichten.

Stand: 15. November 2026 (TYPO3 14.3 LTS)

Quellen:

  • PHP-FIG, PSR-3, PSR-4, PSR-7, PSR-11, PSR-14, PSR-15, PSR-17, PSR-18 und PER Coding Style (php-fig.org)
  • TYPO3 Explained 14.3, Kapitel Request-Lebenszyklus, Middlewares, HTTP-Anfragen an externe Quellen, Coding Guidelines, Autoloading
  • PHP-Handbuch (php.net), Composer-Dokumentation, Symfony-Dokumentation zur Finder-Komponente
  • Quellcode TYPO3 14.3 (typo3/cms-core), geprüft für RequestFactory, Standardwerte unter HTTP und die PHP-Mindestversion

Diese Lernseite ist mit KI erstellt und gegen die Quellen geprüft.

Zertifikate & Prüfungen

Welche Prüfung kommt als Nächstes?

51 Prüfungen kannst du schon üben, über 16 stimmst du gerade ab. Sieh dir alle Zertifikate mit offiziellen Infos an, gib deine Stimme ab oder schlag deine Prüfung vor.

Zur Zertifikatsübersicht