feat(Http) : ajout de la gestion des en-têtes et amélioration des exceptions

Author: dimtrovich

spec/system/framework/Http/ServerRequest.spec.php

@@ -12,6 +12,8 @@
 use BlitzPHP\Filesystem\Files\UploadedFile;
 use BlitzPHP\Http\ServerRequest;
 
+use function Kahlan\expect;
+
 describe('Http / ServerRequest', function (): void {
     describe('Detector', function (): void {
 		it('Custom detector avec des arguments personnalises', function (): void {
@@ -231,14 +233,14 @@
 			$request = new ServerRequest();
 
 			expect(fn() => $request->withUploadedFiles(['avatar' => 'picture']))
-				->toThrow(new InvalidArgumentException('Fichier invalide à `avatar`'));
+				->toThrow(new InvalidArgumentException('Fichier invalide à `avatar`.'));
 		});
 
 		it("Remplacement de fichiers avec un fichier invalide imbriquer.", function (): void {
 			$request = new ServerRequest();
 
 			expect(fn() => $request->withUploadedFiles(['user' => ['avatar' => 'not a file']]))
-				->toThrow(new InvalidArgumentException('Fichier invalide à `user.avatar`'));
+				->toThrow(new InvalidArgumentException('Fichier invalide à `user.avatar`.'));
 		});
 	});
 });

src/Config/schemas/app.config.php

@@ -15,7 +15,7 @@
     'base_url'                     => Expect::string('auto'),
     'charset'                      => Expect::string('UTF-8'),
     'environment'                  => Expect::string('auto'),
-    'language'                     => Expect::string('en'),
+    'locale'                       => Expect::string('en'),
     'force_global_secure_requests' => Expect::bool(false),
     'url_suffix'                   => Expect::string(''),
     'use_absolute_link'            => Expect::bool(true),

src/Exceptions/DebugTraceableTrait.php

@@ -21,13 +21,18 @@
  */
 trait DebugTraceableTrait
 {
+    /**
+     * Code par default de l'exceptio
+     */
+    protected int $_defaultCode = 0;
+
     /**
      * Ajuste le constructeur de l'exception pour assigner le fichier/la ligne à où
      * il est réellement déclenché plutôt que d'être instancié.
      */
-    final public function __construct(string $message = '', int $code = 0, ?Throwable $previous = null)
+    final public function __construct(string $message = '', ?int $code = null, ?Throwable $previous = null)
     {
-        parent::__construct($message, $code, $previous);
+		parent::__construct($message, $code ?? $this->_defaultCode, $previous);
 
         $trace = $this->getTrace()[0];
 

src/Exceptions/HttpException.php

@@ -13,9 +13,50 @@
 
 class HttpException extends FrameworkException
 {
-    public static function methodNotAllowed(string $method): self
+	/**
+     * @inheritDoc
+     */
+    protected int $_defaultCode = 500;
+
+    /**
+     * @var array<non-empty-string, array<string>|string>
+     */
+    protected array $headers = [];
+
+    /**
+     * Définir un seul en-tête de réponse HTTP.
+     *
+     * @param non-empty-string $header Nom de l'en-tête
+     * @param array<string>|string|null $value Valeur de l'en-tête
+     */
+    public function setHeader(string $header, array|string|null $value = null): void
+    {
+        $this->headers[$header] = $value ?? '';
+    }
+
+    /**
+     * Définit les en-têtes de réponse HTTP.
+     *
+     * @param array<non-empty-string, array<string>|string> $headers Tableau de paires nom/valeur d'en-tête.
+     */
+    public function setHeaders(array $headers): void
+    {
+        $this->headers = $headers;
+    }
+
+    /**
+     * Renvoie le tableau d'en-têtes de réponse.
+     *
+     * @return array<non-empty-string, array<string>|string>
+     */
+    public function getHeaders(): array
+    {
+        return $this->headers;
+    }
+
+    public static function methodNotAllowed(string $method): MethodNotFoundException
     {
-        return new static(self::lang('HTTP.methodNotAllowed', [$method]));
+		return new MethodNotFoundException(self::lang('HTTP.methodNotAllowed', [$method]));
     }
 
     public static function invalidStatusCode(int $code)

src/Exceptions/MethodNotFoundException.php

@@ -11,11 +11,13 @@
 
 namespace BlitzPHP\Exceptions;
 
-use RuntimeException;
-
 /**
  * @internal
  */
-final class MethodNotFoundException extends RuntimeException
+final class MethodNotFoundException extends HttpException
 {
+    /**
+     * @inheritDoc
+     */
+    protected int $_defaultCode = 405;
 }