[7.x] Add the exceptionContext method to the exception handler

[AbdelElrafa]

This PR will add the exceptionContext method to the exception handler to allow exception specific data to be added to the logging context.

Currently if you need to get context off of an exception to pass it to the logger you would need to override the whole report method and do it there.

Adding this method allows us to add context off of an exception by simply implementing the method in the applications Handler class. This is not a breaking change.

Example:

throw (new CustomException())->setCustomProperty('foo');

// App/Exceptions/Handler.php
protected function exceptionContext(Exception $e)
{
    if ($e instanceof CustomException) {
        return ['custom_context' => $e->getCustomProperty()];
    }
}

Now the logger can get the custom exception context and handle it just like it handles the other context.

[driesvints]

@AbdelElrafa can you rebase with master? Tests on master have been fixed.

[GrahamCampbell]

I think we also need tests for this feature too, so that it doesn't get broken in the future.

[AbdelElrafa]

@driesvints I rebased.

@GrahamCampbell I had looked into it but dismissed the tests because I didn't find any tests for the context method. The only test that's there is to test that the exception is passed in the context. Let me know if I still should find a way to test it.

[taylorotwell]

I'll just handle this when I merge 6.x forward this week.

[taylorotwell]

Hey @AbdelElrafa, after looking at this again. I think my intention was that you could already override the context method and return array_merge(parent::context(), ['my-context' => 'foo']). Does that not work for you?

[taylorotwell]

Ah, never mind. You are wanting exception specific context.