README

Provides as custom log engine for Bugsnag.

Requirements

• CakePHP 4.x
• PHP 8.x

Installation

[Using Composer]

composer require maartenvr98/cakephp-bugsnag

Enable plugin

Load the plugin in your app's src/Application file:

$this->addPlugin('Bugsnag');

Configuration

Configure the API-Key for Bugsnag in your app's config/app.php file:

'Bugsnag' => [
    'enabled'      => true,
    'apiKey'       => 'YOUR_API_KEY',
    'releaseStage' => 'development'
]

For a complete list of all available options, please refer to Bugsnag's documentation. This plugin doesn't know any limitation, you can use all configuration settings which are listed in Bugsnag's documentation. Please keep in mind that you need to remove the set prefix for each Bugsnag option. setFilters becomes filters, setReleaseStage becomes releaseStage and so on.

Events

If you want to modify the Bugsnag notification before you send it to the their API, you can do this easily with an event listener. You only need to listen to the following event:

Log.Bugsnag.beforeNotify

How you can listen to events is detailed described in Cake's documentation. This plugin comes with a ready to use Listener to provide you the best Bugsnag experience. I suggest to load this listener even if you write your own. You can configure the built in listener in your app's config/bootstrap.php as follows:

use Bugsnag\Listener\BugsnagListener;

EventManager::instance()->on(new BugsnagListener());