Merge pull request #7 from AlexandreGerault/feature/middleware

Feature/middleware

composer.json

@@ -25,14 +25,16 @@
     "psr/simple-cache": "^1.0",
     "ext-pdo": "*",
     "psr/http-server-handler": "^1.0",
-    "beberlei/assert": "^3.3"
+    "beberlei/assert": "^3.3",
+    "psr/http-server-middleware": "^1.0"
   },
   "require-dev": {
     "pestphp/pest": "^1.0",
     "symfony/var-dumper": "^5.2",
     "guzzlehttp/guzzle": "^7.2",
     "phpstan/phpstan": "^0.12.82",
     "jetbrains/phpstorm-attributes": "^1.0",
-    "friendsofphp/php-cs-fixer": "^v3.0.0"
+    "friendsofphp/php-cs-fixer": "^v3.0.0",
+    "pestphp/pest-plugin-mock": "^1.0"
   }
 }

src/AGerault/Contracts/Core/HttpRequestHandlerInterface.php → src/AGerault/Contracts/HTTP/HttpRequestHandlerInterface.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace AGerault\Framework\Contracts\Core;
+namespace AGerault\Framework\Contracts\HTTP;
 
 use Psr\Http\Server\RequestHandlerInterface;
 

src/AGerault/Contracts/HTTP/MiddlewareInterface.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace AGerault\Framework\Contracts\HTTP;
+
+interface MiddlewareInterface extends \Psr\Http\Server\MiddlewareInterface
+{
+
+}

src/AGerault/Contracts/HTTP/MiddlewarePipeInterface.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AGerault\Framework\Contracts\HTTP;
+
+use Generator;
+
+interface MiddlewarePipeInterface
+{
+    public function push(MiddlewareInterface $middleware): void;
+
+    public function generator(): Generator;
+}

src/AGerault/Contracts/Routing/RouteInterface.php

@@ -2,6 +2,8 @@
 
 namespace AGerault\Framework\Contracts\Routing;
 
+use AGerault\Framework\Contracts\HTTP\MiddlewareInterface;
+
 interface RouteInterface
 {
     public function name(): string;
@@ -27,4 +29,7 @@ public function url(): string;
     public function parameters(): array;
 
     public function setParameter(string $parameterName, mixed $value): void;
+
+    /** @return MiddlewareInterface[] */
+    public function middlewares(): array;
 }

src/AGerault/Contracts/Routing/UrlMatcherInterface.php

@@ -2,7 +2,15 @@
 
 namespace AGerault\Framework\Contracts\Routing;
 
+use AGerault\Framework\Routing\Exceptions\RouteNotFoundException;
+
 interface UrlMatcherInterface
 {
+    /**
+     * @param string $uri
+     * @param string $method
+     * @return RouteInterface
+     * @throws RouteNotFoundException
+     */
     public function match(string $uri, string $method): RouteInterface;
 }

src/AGerault/Contracts/Session/SessionInterface.php

@@ -2,8 +2,12 @@
 
 namespace AGerault\Framework\Contracts\Session;
 
-interface SessionInterface
+use ArrayAccess;
+
+interface SessionInterface extends ArrayAccess
 {
+    public function start(): void;
+
     public function has(string $key): bool;
 
     public function get(string $key): mixed;