README

Laravel integration for Errorgap. Auto-registers exception reporting and queue job failure listeners.

Install

composer require errorgap/laravel

The service provider is auto-discovered. Publish the config to customize:

php artisan vendor:publish --tag=errorgap-config

Configure

Add to .env (and .env.example with empty values):

ERRORGAP_ENDPOINT=https://errorgap.example.com
ERRORGAP_PROJECT_SLUG=your-project
ERRORGAP_API_KEY=flk_...

config/errorgap.php reads them via env() calls. Disable individual capture sources with capture_exceptions or capture_jobs.

Manual notification

use Errorgap\Client;

public function handle(Client $errorgap, \Throwable $exc): void
{
    $errorgap->notify($exc, context: ['component' => 'billing']);
}

The same Client is bound via the container, or you can pull it with app('errorgap').

Trigger a test error

Route::get('/errorgap-test', function () {
    throw new \Exception('Errorgap test error');
});

Configuration reference

See config/errorgap.php. Settings map 1:1 onto the base errorgap/errorgap Configuration class.

Development

composer install
composer test

License

MIT.