Configuration¶

You can configure the most important settings for live or debug error handling in the presets:

Admin Tools > Settings > Configuration Presets > Debug Settings

../../../_images/DebugConfigurationPresets.png

Enable the debug settings in the Admin Tools¶

For more fine-grained error handling you can change various settings in:

Admin Tools > Settings > Configure Installation-Wide Options > SYS

It is also possible to write changes manually into the configuration file config/system/settings.php or config/system/additional.php. Most configuration options related to error and exception handling are part of $GLOBALS['TYPO3_CONF_VARS']['SYS'].

The following configuration values are of interest:

$GLOBALS['TYPO3_CONF_VARS']['BE']['debug']: If enabled, the login refresh is disabled and pageRenderer is set to debug mode. Furthermore the fieldname is appended to the label of fields.
$GLOBALS['TYPO3_CONF_VARS']['FE']['debug']: If enabled, the total parse time of the page is added as HTTP response header X-TYPO3-Parsetime.
$GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask']: Defines a list of IP addresses which will allow development output to display. Setting to "*" will allow all. Setting it to an empty string allows none.
$GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors']: Configures whether PHP errors or Exceptions should be displayed.
$GLOBALS['TYPO3_CONF_VARS']['SYS']['errorHandler']: Classname to handle PHP errors. Leave empty to disable error handling.
$GLOBALS['TYPO3_CONF_VARS']['SYS']['errorHandlerErrors']: The E_* constants that will be handled by the error handler.
$GLOBALS['TYPO3_CONF_VARS']['SYS']['exceptionalErrors']: The E_* constant that will be converted into an exception by the default errorHandler.
$GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler']: The default exception handler displays a nice error message when something goes wrong. The error message is logged to the configured logs.
$GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler']: The default debug exception handler displays the complete stack trace of any encountered exception. The error message and the stack trace is logged to the configured logs.
$GLOBALS['TYPO3_CONF_VARS']['SYS']['belogErrorReporting']: Configures which PHP errors should be logged to the sys_log table.