Callback, faking route and documentation updates

src/Pecee/Http/Middleware/IMiddleware.php

@@ -2,7 +2,15 @@
 namespace Pecee\Http\Middleware;
 
 use Pecee\Http\Request;
+use Pecee\SimpleRouter\RouterEntry;
 
 interface IMiddleware {
-    public function handle(Request $request);
+
+    /**
+     * @param Request $request
+     * @param RouterEntry|null $route
+     * @return Request|null
+     */
+    public function handle(Request $request, RouterEntry &$route = null);
+
 }