add publish method and add example dir

miladrahimi · Milad Rahimi · commit c52d2c6b72c3 · 2019-03-06T18:26:56.000+03:30
diff --git a/example/index.php b/example/index.php
@@ -0,0 +1,57 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * User: Milad Rahimi <info@miladrahimi.com>
+ * Date: 7/13/2018 AD
+ * Time: 18:33
+ */
+
+use MiladRahimi\Router\Exceptions\RouteNotFoundException;
+use MiladRahimi\Router\Router;
+use Zend\Diactoros\Response\EmptyResponse;
+use Zend\Diactoros\Response\HtmlResponse;
+use Zend\Diactoros\Response\JsonResponse;
+use Zend\Diactoros\Response\RedirectResponse;
+use Zend\Diactoros\Response\TextResponse;
+use Zend\Diactoros\ServerRequest;
+
+require './../vendor/autoload.php';
+
+$router = new Router();
+
+$router->get('/', function (ServerRequest $request) {
+    return new JsonResponse([
+        'method' => $request->getMethod(),
+        'uri' => $request->getUri(),
+        'body' => $request->getBody(),
+        'headers' => $request->getHeaders(),
+    ]);
+});
+
+$router->post('/', function () {
+    $html = '<html>Object successfully created.</html>';
+
+    return new HtmlResponse($html, 201);
+});
+
+$router->put('/{id}', function ($id) {
+    $text = 'The entity with ' . $id . ' updated.';
+
+    return new TextResponse($text);
+});
+
+$router->patch('/{id}', function () {
+    return new EmptyResponse();
+});
+
+$router->get('/redirect', function () {
+    return new RedirectResponse('https://miladrahimi.com');
+});
+
+try {
+    $router->dispatch();
+} catch (RouteNotFoundException $e) {
+    $router->publish(new EmptyResponse(404));
+} catch (Throwable $e) {
+    echo '<pre>' . print_r($e, true) . '</pre>';
+}
diff --git a/src/MiladRahimi/Router/Router.php b/src/MiladRahimi/Router/Router.php
@@ -188,6 +188,9 @@ public function map(
     /**
      * Dispatch routes and run the application
      *
+     * @throws InvalidControllerException
+     * @throws InvalidMiddlewareException
+     * @throws RouteNotFoundException
      * @throws Throwable
      */
     public function dispatch()
@@ -211,7 +214,7 @@ public function dispatch()
                     RouteAttributes::URI => $routeAttributes[RouteAttributes::URI],
                 ];
 
-                $this->publisher->publish($this->run($routeAttributes, $routeParameters));
+                $this->publish($this->run($routeAttributes, $routeParameters));
 
                 return;
             }
@@ -226,6 +229,8 @@ public function dispatch()
      * @param array $routeAttributes
      * @param array $routeParameters
      * @return mixed|ResponseInterface
+     * @throws InvalidControllerException
+     * @throws InvalidMiddlewareException
      * @throws Throwable
      */
     private function run(array $routeAttributes, array $routeParameters)
@@ -284,6 +289,7 @@ private function runControllerThroughMiddleware(array $middleware, Closure $cont
      * @param Closure|callable|string $controller
      * @param array $parameters
      * @return ResponseInterface|null
+     * @throws InvalidControllerException
      * @throws Throwable
      */
     private function runController($controller, array $parameters)
@@ -525,7 +531,7 @@ public function patch(
      *
      * @param string $route
      * @param Closure|callable|string $controller
-     * @param \MiladRahimi\Router\Services\Middleware|Middleware[] $middleware
+     * @param Middleware|Middleware[] $middleware
      * @param string|null $domain
      * @param string|null $name
      */
@@ -613,6 +619,16 @@ public function currentRouteName()
         return null;
     }
 
+    /**
+     * Publish http response manually
+     *
+     * @param $httpResponse
+     */
+    public function publish($httpResponse)
+    {
+        $this->publisher->publish($httpResponse);
+    }
+
     /**
      * Get current http request instance
      *
