https://github.com/smichaelsen/typo3-airbrake

https://github.com/smichaelsen/typo3-airbrake

Last synced: 30 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/smichaelsen/typo3-airbrake
• Owner: smichaelsen
• Created: 2016-05-14T19:53:57.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2020-06-19T13:40:34.000Z (over 4 years ago)
• Last Synced: 2024-04-24T03:14:55.883Z (8 months ago)
• Language: PHP
• Size: 15.6 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# TYPO3 Extension: Airbrake

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. |