update README.md

Author: fenric

README.md

@@ -12,7 +12,7 @@
 ## Installation
 
 ```bash
-composer require 'sunrise/http-router:^2.6'
+composer require 'sunrise/http-router:^2.8'
 ```
 
 ## QuickStart
@@ -81,13 +81,26 @@ $loader->attachArray([
 $router = new Router();
 $router->load($loader);
 
+// if the router matching should be isolated for top middlewares...
+// for example for error handling...
+// [!] available from version 2.8
+$response = $router->run($request);
+
 // if the router is used as a request handler
 $response = $router->handle($request);
 
 // if the router is used as middleware
 $response = $router->process($request, $handler);
 ```
 
+```php
+/** @var Sunrise\Http\Router\RouteCollector $this */
+
+$this->get('home', '/', new CallableRequestHandler(function ($request) {
+    return (new ResponseFactory)->createJsonResponse(200);
+}));
+```
+
 #### Strategy loading routes from descriptors (annotations or attributes)
 
 ```php
@@ -111,6 +124,11 @@ $loader->attachArray([
 $router = new Router();
 $router->load($loader);
 
+// if the router matching should be isolated for top middlewares...
+// for example for error handling...
+// [!] available from version 2.8
+$response = $router->run($request);
+
 // if the router is used as a request handler
 $response = $router->handle($request);
 
@@ -131,13 +149,56 @@ $collector->get('home', '/', new HomeController());
 $router = new Router();
 $router->addRoute(...$collector->getCollection()->all());
 
+// if the router matching should be isolated for top middlewares...
+// for example for error handling...
+// [!] available from version 2.8
+$response = $router->run($request);
+
 // if the router is used as a request handler
 $response = $router->handle($request);
 
 // if the router is used as middleware
 $response = $router->process($request, $handler);
 ```
 
+#### Error handling example
+
+```php
+use Sunrise\Http\Message\ResponseFactory;
+use Sunrise\Http\Router\Exception\MethodNotAllowedException;
+use Sunrise\Http\Router\Exception\RouteNotFoundException;
+use Sunrise\Http\Router\Middleware\CallableMiddleware;
+use Sunrise\Http\Router\RequestHandler\CallableRequestHandler;
+use Sunrise\Http\Router\RouteCollector;
+use Sunrise\Http\Router\Router;
+use Sunrise\Http\ServerRequest\ServerRequestFactory;
+
+use function Sunrise\Http\Router\emit;
+
+$collector = new RouteCollector();
+
+$collector->get('home', '/', new CallableRequestHandler(function ($request) {
+    return (new ResponseFactory)->createJsonResponse(200);
+}));
+
+$router = new Router();
+$router->addRoute(...$collector->getCollection()->all());
+
+$router->addMiddleware(new CallableMiddleware(function ($request, $handler) {
+    try {
+        return $handler->handle($request);
+    } catch (MethodNotAllowedException $e) {
+        return (new ResponseFactory)->createResponse(405);
+    } catch (RouteNotFoundException $e) {
+        return (new ResponseFactory)->createResponse(404);
+    } catch (Throwable $e) {
+        return (new ResponseFactory)->createResponse(500);
+    }
+}));
+
+emit($router->run(ServerRequestFactory::fromGlobals()));
+```
+
 #### Route Annotation Example
 
 ##### Minimal annotation view