TYPO3 Application Context verstehen und richtig einsetzen

In älteren TYPO3-Versionen wurden Fehlermeldungen ungefiltert im Frontend ausgegeben. Das hatte den unangenehmen Nebeneffekt, dass sicherheitsrelevante Daten wie Datenbankzugänge, E-Mail-Adressen oder SMTP-Logins für die Öffentlichkeit sichtbar wurden. Um dieses Risiko auszuschalten, wurde mit neueren TYPO3-Versionen der sogenannte ApplicationContext eingeführt.

Was ist der ApplicationContext?

Der ApplicationContext legt fest, in welchem „Modus“ TYPO3 betrieben wird. Damit lassen sich Fehlermeldungen, Logging und Caching gezielt steuern. Gleichzeitig können Entwickler:innen den Kontext an verschiedenen Stellen (z. B. in der Site-Konfiguration) abfragen, um bestimmte Varianten zu erzwingen.

TYPO3 kennt drei Standard-Kontexte, die jeweils unterschiedliche Voreinstellungen mitbringen:

Production

  • Nur echte Fehler werden protokolliert.
  • Veraltete (deprecated) Funktionsaufrufe werden nicht geloggt.
  • Im Frontend erscheint bei einem Fehler lediglich: Oops, an error occurred! Code: {code}.
  • Der Dependency-Injection-Cache kann nicht ĂĽber „Alle Caches löschen“ geleert werden, sondern nur ĂĽber das Install Tool oder den CLI-Befehl cache:flush.
  • Der Zugriff auf MenĂĽpunkte des Install Tools erfordert ein zusätzliches Passwort („sudo mode“).
  • Nur Admins mit System-Maintainer-Rechten sehen die Install-Tool-MenĂĽs.
  • Höchste Performance und Sicherheit – fĂĽr Live-Systeme empfohlen.

Development

  • Fehler und Warnungen werden protokolliert.
  • Veraltete Funktionsaufrufe landen in einer separaten Logdatei.
  • Fehler erscheinen im Frontend mit genauer Angabe, wo sie entstanden sind.
  • Im Backend wird beim Bearbeiten von Datensätzen das zugehörige Tabellenfeld in eckigen Klammern hinter dem Label angezeigt.
  • „Alle Caches löschen“ leert zusätzlich den Dependency-Injection-Cache.
  • FĂĽr Install-Tool-MenĂĽs ist kein zusätzliches Passwort mehr nötig.
  • Auch Admins ohne Maintainer-Rechte sehen die MenĂĽpunkte.
  • Ideal fĂĽr die lokale Entwicklung.

Testing

  • Spezieller Modus, in dem das Caching fĂĽr Class Loading deaktiviert oder nur fĂĽr eine einzelne Anfrage gĂĽltig ist.
  • Wird vor allem fĂĽr automatisierte Tests eingesetzt.

Der Einsatz von .env-Dateien

Gerade in Composer-basierten TYPO3-Projekten ist es ĂĽblich, den ApplicationContext und weitere Variablen ĂĽber .env-Dateien zu steuern. Diese werden im Projekt-Stammverzeichnis abgelegt und ihre Inhalte als Umgebungsvariablen verfĂĽgbar gemacht.

Die Basis hierfĂĽr bildet der Symfony .env-Loader symfony/dotenv. Da dieser eine Initialisierung erfordert, empfiehlt sich der Einsatz des Pakets helhum/dotenv-connector, das diese Schritte automatisch ĂĽbernimmt.

Installation

                            composer req helhum/dotenv-connector

Mit diesem Setup lässt sich der gewünschte ApplicationContext bequem per Umgebungsvariable festlegen, zum Beispiel:

                            TYPO3_CONTEXT=Development

Fazit

Der ApplicationContext ist ein zentrales Werkzeug, um TYPO3 sicher und flexibel zu betreiben. Während Production für maximale Sicherheit und Geschwindigkeit im Live-Betrieb sorgt, liefern Development und Testing hilfreiche Informationen für Entwickler:innen. Mit der Integration von .env-Dateien wird die Verwaltung der Kontexte zusätzlich vereinfacht und klar strukturiert.

TYPO3

Back