add global middlewares

README.md

@@ -140,6 +140,22 @@ public function handle($request, Closure $next)
 }
 ```
 
+you can use Request::withGlobalMiddlewares to add global middlewares.
+global middlewares will be binded to all requests.
+
+```php
+
+// in your AppServiceProvider
+
+protected boot()
+{
+    Request::withGlobalMiddlewares([
+        // list of middlewares
+    ]);
+}
+
+```
+
 ##### Cache
 
 you can cache responses according to requests.

src/Classes/Request.php

@@ -7,14 +7,13 @@
 use Shetabit\Extractor\Traits\Conditional;
 use Shetabit\Extractor\Traits\HasParsedUri;
 use GuzzleHttp\Client;
-use Shetabit\Extractor\Contracts\MiddlewareInterface;
-use Shetabit\Extractor\Middlewares\CacheMiddleware;
-use Shetabit\Extractor\Middlewares\Middleware;
+use Shetabit\Extractor\Traits\HasMiddleware;
 
 class Request implements RequestInterface
 {
     use HasParsedUri;
     use Conditional;
+    use HasMiddleware;
 
     /**
      * Request's EndPoint
@@ -108,13 +107,6 @@ class Request implements RequestInterface
      */
     protected $onErrorCallback = null;
 
-    /**
-     * Middlewares
-     *
-     * @var array
-     */
-    protected $middlewares = [];
-
     /**
      * Request constructor.
      *
@@ -631,56 +623,4 @@ public function createBag()
     {
         return new Bag();
     }
-
-    /**
-     * Bind cache middleware
-     *
-     * @param $ttl
-     *
-     * @return $this
-     */
-    public function cache($ttl = 10)
-    {
-        $this->middleware(new CacheMiddleware($ttl));
-
-        return $this;
-    }
-
-    /**
-     * Add middlewares
-     *
-     * @param MiddlewareInterface $middleware
-     *
-     * @return $this
-     */
-    public function middleware(MiddlewareInterface $middleware)
-    {
-        array_push($this->middlewares, $middleware);
-
-        return $this;
-    }
-
-    /**
-     * Retrieve a chain of middlewares
-     *
-     * @return MiddlewareInterface
-     */
-    protected function createMiddlewaresChain()  : ?MiddlewareInterface
-    {
-        $chain = new Middleware;
-        $middlewares = $this->middlewares;
-
-        $latest = null;
-        foreach ($middlewares as $middleware) {
-            if (is_null($latest)) {
-                $chain->linkWith($middleware);
-            } else {
-                $latest->linkWith($middleware);
-            }
-
-            $latest = $middleware;
-        }
-
-        return $chain;
-    }
 }

src/Traits/HasMiddleware.php

@@ -0,0 +1,118 @@
+<?php
+
+namespace Shetabit\Extractor\Traits;
+
+use Shetabit\Extractor\Contracts\MiddlewareInterface;
+use Shetabit\Extractor\Middlewares\CacheMiddleware;
+use Shetabit\Extractor\Middlewares\Middleware;
+
+trait HasMiddleware
+{
+    /**
+     * Global middlewares
+     * this middlewares that will be binded into all requests
+     *
+     * @var array
+     */
+    public static $globalMiddlewares = [];
+
+    /**
+     * A list of middlewares that's not expected to run
+     *
+     * @var array
+     */
+    public $bannedMiddlewares = [];
+
+    /**
+     * Middlewares
+     *
+     * @var array
+     */
+    protected $middlewares = [];
+
+    /**
+     * Add global middlewares
+     *
+     * @param array $middlewares
+     *
+     * @return void
+     */
+    public static function withGlobalMiddlewares(array $middlewares)
+    {
+        foreach($middlewares as $middleware) {
+            $middlewareInstance = ($middleware instanceof MiddlewareInterface) ? $middleware : new $middleware;
+
+            array_push(static::$globalMiddlewares, $middlewareInstance);
+        }
+    }
+
+    /**
+     * Add a middleware that's not expected to run
+     *
+     * @param MiddlewareInterface $middleware
+     *
+     * @return $this
+     */
+    public function withoutMiddleware(MiddlewareInterface $middleware)
+    {
+        array_push($this->bannedMiddlewares, $middleware);
+
+        return $this;
+    }
+
+    /**
+     * Bind cache middleware
+     *
+     * @param $ttl
+     *
+     * @return $this
+     */
+    public function cache($ttl = 10)
+    {
+        $this->middleware(new CacheMiddleware($ttl));
+
+        return $this;
+    }
+
+    /**
+     * Add middlewares
+     *
+     * @param MiddlewareInterface $middleware
+     *
+     * @return $this
+     */
+    public function middleware(MiddlewareInterface $middleware)
+    {
+        array_push($this->middlewares, $middleware);
+
+        return $this;
+    }
+
+    /**
+     * Retrieve a chain of middlewares
+     *
+     * @return MiddlewareInterface
+     */
+    protected function createMiddlewaresChain()  : ?MiddlewareInterface
+    {
+        $chain = new Middleware;
+
+        $middlewares = array_diff(
+            array_merge(static::$globalMiddlewares, $this->middlewares),
+            $this->bannedMiddlewares
+        );
+
+        $latest = null;
+        foreach ($middlewares as $middleware) {
+            if (is_null($latest)) {
+                $chain->linkWith($middleware);
+            } else {
+                $latest->linkWith($middleware);
+            }
+
+            $latest = $middleware;
+        }
+
+        return $chain;
+    }
+}