4.x - Add route context helper

[shadowhand]

Creates a new RouteContext class that can be used to gain access to the current request route, route parser, and routing results.

Fixes #2758
Fixes #2761

[coveralls]

Coverage remained the same at 100.0% when pulling 42717a2 on shadowhand:feature/route-context into c4bdfa0 on slimphp:4.x.

[adriansuter]

Looks good, althoug I have to check in more depth.

Could you please add the slim file header comment to the two new files?

[shadowhand]

@adriansuter ✅

[adriansuter]

In RouteContex::fromRequest(), should we check if the three calls to
$serverRequest->getAttribute() did not return null?

[shadowhand]

@adriansuter and do what? Throw an exception? PHP will already throw a TypeError if the values are null when trying to construct the RouteContext.

[l0gicgate]

@shadowhand we need to throw an exception to notify the user that routing hasn't been performed if those attributes are null. Probably throw a RuntimeException

[adriansuter]

Or an InvalidArgumentException as actually the given argument does not have sufficient information.

But then, a call to this static method has to be wrapped into a try-catch block. Probably it is better to throw a RuntimeException.

[shadowhand]

@l0gicgate @adriansuter updated with your requested changes.

[adriansuter]

Some imports can be removed.

[l0gicgate]

Looks good to me @adriansuter can you review one last time before I merge please?

[adriansuter]

Thanks - everything is fine.

[adriansuter]

We should not forget to update the docs about this new feature.

[l0gicgate]

@adriansuter absolutely