smichaelsen/airbrake

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

Installs: 575

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 1

Forks: 0

Open Issues: 0

Type:typo3-cms-extension

2.0.0 2020-06-19 10:07 UTC

This package is auto-updated.

Last update: 2021-03-19 15:12:31 UTC


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.