middleware in dispatch event doc moved to cookbook

Author: samsonasik

doc/book/cookbook/using-middleware-in-dispatch-event.md

@@ -0,0 +1,41 @@
+# Using Middleware in "dispatch" Event
+
+During Mvc Workflow, you can use the Middleware in 'dispatch' event by provide `Psr7Bridge`. For example, you have `AuthorizationMiddleware`:
+
+```php
+namespace Application\Middleware;
+
+class AuthorizationMiddleware
+{
+    public function __invoke($request, $response, $next = null)
+    {
+        // handle authorization here...
+    }
+}
+```
+
+As the request and response in 'dispatch' event is a `Zend\Http` Request and Response object, we need the bridge to convert into PSR-7 Request and Response. To do that, you can do the following:
+
+```php
+namespace Application;
+
+use Application\Middleware\AuthorizationMiddleware;
+use Zend\Psr7Bridge\Psr7ServerRequest;
+use Zend\Psr7Bridge\Psr7Response;
+
+class Module
+{
+    public function onBootstrap($e)
+    {
+        $app          = $e->getApplication();
+        $eventManager = $app->getEventManager();
+        $services     = $app->getServiceManager();
+
+        $eventManager->attach('dispatch', function ($e) use ($services) {
+            $request  = Psr7ServerRequest::fromZend($e->getRequest());
+            $response = Psr7Response::fromZend($e->getResponse());
+            $result   = ($services->get(AuthorizationMiddleware::class))($request, $response);
+        }, 2);
+    }
+}
+```

doc/book/middleware.md

@@ -106,45 +106,3 @@ causing the application to short-circuit and return the response immediately.
 You can, however, return arbitrary values. If you do, the result is pushed into
 the `MvcEvent` as the event result, allowing later dispatch listeners to
 manipulate the results.
-
-## Using Middleware in 'dispatch' Event
-
-During Mvc Workflow, you can use the Middleware in 'dispatch' event by provide `Psr7Bridge`. For example, you have `AuthorizationMiddleware`:
-
-```php
-namespace Application\Middleware;
-
-class AuthorizationMiddleware
-{
-    public function __invoke($request, $response, $next = null)
-    {
-        // handle authorization here...
-    }
-}
-```
-
-As the request and response in 'dispatch' event is a `Zend\Http` Request and Response object, we need the bridge to convert into PSR-7 Request and Response. To do that, you can do the following:
-
-```php
-namespace Application;
-
-use Application\Middleware\AuthorizationMiddleware;
-use Zend\Psr7Bridge\Psr7ServerRequest;
-use Zend\Psr7Bridge\Psr7Response;
-
-class Module
-{
-    public function onBootstrap($e)
-    {
-        $app          = $e->getApplication();
-        $eventManager = $app->getEventManager();
-        $services     = $app->getServiceManager();
-
-        $eventManager->attach('dispatch', function ($e) use ($services) {
-            $request  = Psr7ServerRequest::fromZend($e->getRequest());
-            $response = Psr7Response::fromZend($e->getResponse());
-            $result   = ($services->get(AuthorizationMiddleware::class))($request, $response);
-        }, 2);
-    }
-}
-```

mkdocs.yml

@@ -14,6 +14,8 @@ pages:
       - Examples: examples.md
       - 'Dispatching PSR-7 Middleware': middleware.md
       - 'Migration Guide': migration.md
+    - Cookbook:
+      - 'Using Middleware in "dispatch" Event': cookbook/using-middleware-in-dispatch-event.md
 site_name: zend-mvc
 site_description: 'zend-mvc: MVC application provider'
 repo_url: 'https://github.com/zendframework/zend-mvc'