Implement fromRoute() and getMatchedRoute()

[weierophinney]

RouteResult::fromRoute() expects a Route instance, and, optionally, the parameters matched during routing, and returns an instance representing a successful route match. The various getters, other than getMatchedParams(), then proxy to the underlying Route instance. getMatchedRoute() returns the matched Route instance, allowing consumers to pull additional information from it, including the path, options, etc.

This patch also deprecates fromRouteMatch(), as it becomes redundant when the Route instance is present.

Finally, this patch would supercede #21 and fix #12, as the user could then perform the following to get the path:

$result = $request->getAttribute(RouteResult::class);
$path = $result->getRoute()->getPath();

(The user would also now be able to retrieve allowed methods for the given route, using the getAllowedMethods() method on either the RouteResult or composed Route, making this solution more flexible.)

This approach is completely backwards compatible, but, because it provides new functionality, would require a new minor version (1.3.0 is the target).

[coveralls]

Coverage remained the same at 100.0% when pulling b800d23 on weierophinney:feature/result-compose-route into 908e910 on zendframework:develop.