Attention

TYPO3 v10 has reached end-of-life as of April 30th 2023 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 v10 here: TYPO3 ELTS.

Configuration

All configuration options related to error and exception handling are part of $GLOBALS['TYPO3_CONF_VARS'][SYS]:

Key

Data type

Description

displayErrors

integer

Configures whether PHP errors should be displayed.

  • 0 = Do not display any PHP error messages. Overrides the value of "exceptionalErrors" and sets it to 0 (= no errors are turned into exceptions),the configured productionExceptionHandler is used as exception handler

  • 1 = Display error messages with the registered error handler, the configured debugExceptionHandler is used as exception handler

  • -1 = Default setting. With this option, you can override the PHP setting display_errors. If devIPmask matches the users IP address the configured debugExceptionHandler is used for exceptions, if not productionExceptionHandler will be used.

errorHandler

string

Classname to handle PHP errors. Leave empty to disable error handling.

Default: \TYPO3\CMS\Core\Error\ErrorHandler. This class will register itself as error handler. It is able to write error messages to all available logging systems in TYPO3. See Logging Framework for more.

Additionally the errors can be displayed as flash messages in the Backend or in the adminpanel in Frontend. The flash messages in Backend are only displayed if the error and exception handling is in "debug-mode", which is the case when the configured "debugExceptionHandler" is registered as exception handler (see: $GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors']).

Errors which are registered as "exceptionalErrors" will be turned into exceptions (to be handled by the configured exceptionHandler).

errorHandlerErrors

integer

The E_* constant that will be handled by the error handler

Default: E_ALL ^ E_NOTICE

exceptionalErrors

integer

The E_* constant that will be handled as an exception by the error handler.

Default: E_ALL ^ E_NOTICE ^ E_WARNING ^ E_USER_ERROR ^ E_USER_NOTICE ^ E_USER_WARNING (4341) and "0" if $GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'] = 0.

Refer to the PHP documentation for more details on this value.

productionExceptionHandler

string

Classname to handle exceptions that might happen in the TYPO3-code.

Leave empty to disable exception handling.

Default: \TYPO3\CMS\Core\Error\ProductionExceptionHandler. This exception handler displays a nice error message when something went wrong. The error message is logged to the configured logs.

Note

The configured productionExceptionHandler is used if $GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'] is set to "0" or to "-1" and $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'] doesn't match.

debugExceptionHandler

string

Classname to handle exceptions that might happen in the TYPO3 code.

Leave empty to disable exception handling.

Default: \TYPO3\CMS\Core\Error\DebugExceptionHandler. This exception handler displays the complete stack trace of any encountered exception. The error message and the stack trace is logged to the configured logs.

Note

The configured debugExceptionHandler is used if $GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'] is set to "1" or if $GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'] is "-1" or "2" and the $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'] matches.

belogErrorReporting

integer

Configures which PHP errors should be logged to the "sys_log" table (extension: belog). If set to "0" no PHP errors are logged to the "sys_log" table.

Default: E_ALL ^ E_NOTICE (6135).

The table below shows which values can be set by the user and which are set by TYPO3.

Values in plain text can be changed in LocalConfiguration.php.

Values in bold are set by TYPO3.

displayErrors

errorHandlerErrors

exceptionalErrors

errorHandler

devIPmask

exceptionHandler

display_errors

(php_ini)

-1

E_ALL ^ E_NOTICE

E_ALL ^ E_NOTICE ^ E_WARNING ^ E_USER_ERROR ^ E_USER_NOTICE

TYPO3CMS CoreError ErrorHandler

Matters

If devIPmask matches: debugExceptionHandler

Not changed

If devIPmask doesn't match: productionExceptionHandler

Not changed

0

E_ALL ^ E_NOTICE

0 (no errors are turned into exceptions)

TYPO3CMS CoreError ErrorHandler

Doesn't matter

production ExceptionHandler

0 (Off)

1

E_ALL ^ E_NOTICE

E_ALL ^ E_NOTICE ^ E_WARNING ^ E_USER_ERROR ^ E_USER_NOTICE ^ E_USER_WARNING

TYPO3CMS CoreError ErrorHandler

Doesn't matter

debugException Handler

1 (On)

Tip

Search for php error calculator in the web.

PHP constants:

    1  E_ERROR            Fatal run-time errors.
    2  E_WARNING           Run-time warnings (non-fatal errors).
    4  E_PARSE             Compile-time parse errors.
    8  E_NOTICE            Run-time notices.
   16  E_CORE_ERROR        Fatal errors that occur during PHP's initial startup.
   32  E_CORE_WARNING      Warnings (non-fatal errors) that occur during PHP's initial startup.
   64  E_COMPILE_ERROR     Fatal compile-time errors.
  128  E_COMPILE_WARNING   Compile-time warnings (non-fatal errors).
  256  E_USER_ERROR        User-generated error message.
  512  E_USER_WARNING      User-generated warning message.
 1024  E_USER_NOTICE       User-generated notice message.
 2048  E_STRICT            Enable to have PHP suggest changes to your code.
 4096  E_RECOVERABLE_ERROR Catchable fatal error. It indicates that a probably dangerous error occurred, but did not leave the Engine in an unstable state. If the error is not caught by a user defined handle (see also set_error_handler()), the application aborts as it was an E_ERROR.         Since PHP 5.2.0
 8192  E_DEPRECATED        Run-time notices.
16384  E_USER_DEPRECATED   User-generated warning message.
----------------------------------------------------------------------------
32767  E_ALL               (Use ~0 in the code to set all bits.)

Defaults:

30711                      SYS/belogErrorReporting  = E_ALL & ~(E_STRICT | E_NOTICE)

30466                      SYS/errorHandlerErrors  = E_WARNING     | E_USER_ERROR        | E_USER_WARNING |
                                                     E_USER_NOTICE | E_RECOVERABLE_ERROR | E_DEPRECATED   |
                                                     E_USER_DEPRECATED

30711                      SYS/syslogErrorReporting = E_ALL & ~(E_STRICT | E_NOTICE)

Typical in TYPO3 for production:

20480                      SYS/exceptionalErrors   = E_RECOVERABLE_ERROR | E_USER_DEPRECATED

Typical in TYPO3 for development:

28674                      SYS/exceptionalErrors   = E_WARNING | E_RECOVERABLE_ERROR | E_DEPRECATED | E_USER_DEPRECATED

The following sections highlight the roles and goals of the various classes related to error and exception handling. Examples and custom handlers are also discussed.