Introduce captureUnhandledException

[stayallive]

Currently we ask users to implement this in their error handler:

public function register()
{
    $this->reportable(function (Throwable $e) {
        if (app()->bound('sentry')) {
            app('sentry')->captureException($e);
        }
    });
}

However going forward we are going to change this to:

public function register()
{
    $this->reportable(function (Throwable $e) {
        \Sentry\Laravel\Integration::captureUnhandledException($e);
    });
}

The old way will still work but the "new way" will make sure exception are correctly marked as unhandled in the Sentry UI.

Fixes #607 (TODO: Docs PR)

[cleptric]

Should we also update the Monolog handler?

sentry-laravel/src/Sentry/Laravel/SentryHandler.php

Line 242 in 8ce9684

$this->hub->captureException($exception);

[stayallive]

I did thought about that, however, it's not certain that we have a unhandled exception there since a user could also just log an exception like they would use captureException, so it wouldn't be a 100% correct. WDYT?

[cleptric]

Fair point, so let's leave it as is.

[devfrey]

After switching from captureException() to captureUnhandledException() I'm no longer seeing any additional context in Sentry. No headers, no user, no breadcrumbs.

I'm using v3.1.0 of sentry/sentry-laravel.

[stayallive]

@devfrey you are right... fixing that now @ #611!

[stayallive]

3.1.1 was just released fixing this, sorry for that!

[devfrey]

Thanks! Can confirm the patch fixed it.

All exceptions are now reported as unhandled. Even the ones manually logged through Laravel's report() helper – which I use to 'soft'-report exceptions that didn't crash the application. How did you intend to make a distinction between handled and unhandled exceptions? Laravel doesn't have a concept of handled vs. unhandled exceptions.

[cleptric]

@devfrey @axlon 3.1.2 was just released that properly sets the handled property when using report().

[cleptric]

Yes, report_if() and report_unless() are also set to handled: true 🙂