smichaelsen/airbrake

There is no license information available for the latest version (2.0.0) of this package.

2.0.0 2020-06-19 10:07 UTC

Requires

• dbtlr/php-airbrake: *
• typo3/cms-core: ^8.7 || ^9.5

Unknown License

README

Logs PHP Exceptions to airbrake.io or alternative services that are API compliant to airbrake.io. At the moment only exceptions in ContentElement are handled. Other frontendexceptions and all backend exceptions are not supported (handled) yet.

Setup

Replace contentObjectExceptionHandler

After installing the extension, include its Static TypoScript Template and then configure your airbrake.io project ID and key in the TS Constant Editor.

Replace debugExceptionHandler

$GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler'] = \Smichaelsen\Airbrake\ExceptionHandler\GeneralExceptionHandler::class;

Replace productionExceptionHandler

$GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'] = \Smichaelsen\Airbrake\ExceptionHandler\GeneralExceptionHandler::class;

TypoScript Reference

These options are available in plugin.tx_airbrake. All of them are also configurable via the constant editor. All of them have stdWrap enabled.

option	default	description
projectId	(empty)	Project ID for airbrake
projectKey	(empty)	Project Key for airbrake
host	api.airbrake.io	URL of your airbrake host.
stillLogExceptionToLogfile	false	TYPO3 usually logs production exceptions to typo3temp/logs/ and airbrake disables this behaviour. If this is set to true, TYPO3 will keep logging to the file.

Other TypoScript

These settings are not introduced by EXT:airbrake but can be useful for you:

option	description
config.contentObjectExceptionHandler	This is set to Smichaelsen\Airbrake\ExceptionHandler\ContentObjectExceptionHandler by EXT:airbrake to register it as exception handler for content objects. Unsetting it will restore TYPO3's default behaviour.
config.contentObjectExceptionHandler.errorMessage	This is TYPO3's option to change the default message ("Oops, an error occurred! Code: SOMEEXCEPTIONIDENTIFIER"). Also note that EXT:airbrake changes the TYPO3 default message to a localized message if you set nothing here.