Attention
TYPO3 v12 has reached end-of-life as of April 30th 2026 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.
Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here: TYPO3 ELTS.
The logging framework (developer guide)
This chapter is intended for developers who want to use the TYPO3 logging framework in their extensions, middleware, or custom services.
It explains the internal architecture of the logging system and how to interact with it programmatically.
If you're looking for production-level logging guidance (e.g., log rotation, monitoring, or security), see: Logging considerations during production.
The chapter Quickstart: Writing to the logger from PHP helps you get started.
TYPO3 Logging consists of the following components:
- A Logger that receives the log message and related details, like a severity.
- A LogRecord model which encapsulates the data
- Configuration of the logging system
- Writers which write the log records to different targets (like file, database, rsyslog server, etc.)
- Processors which enhance the log record with more detailed information.
See also
Are you looking for information on how to configure logging for production environments (log rotation, error monitoring, security)? See Logging in production.
Contents: