Updated codebase to new standards and php 7.4

Author: shudd3r

cs-fixer.php.dist

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 /*
  * This file is part of Polymorphine/Headers package.

src/Cookie.php

@@ -20,6 +20,9 @@ interface Cookie
     const NAME_EXTRA_CHARS  = '!\#$%&\'*+\-.^_`|~';
     const VALUE_EXTRA_CHARS = self::NAME_EXTRA_CHARS . '\/:=?\@()[\]{}<>';
 
+    /**
+     * @return string
+     */
     public function name(): string;
 
     /**

src/Cookie/CookieSetup.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 /*
  * This file is part of Polymorphine/Headers package.
@@ -20,9 +20,12 @@ class CookieSetup
 {
     private const FIVE_YEARS_IN_SEC = 157680000;
 
-    private $responseHeaders;
-    private $directives;
+    private ResponseHeaders $responseHeaders;
+    private array           $directives;
 
+    /**
+     * @param ResponseHeaders $responseHeaders
+     */
     public function __construct(ResponseHeaders $responseHeaders)
     {
         $this->responseHeaders = $responseHeaders;
@@ -54,7 +57,7 @@ public function directives(array $directives = []): self
             'MaxAge'   => null,
             'Secure'   => false,
             'HttpOnly' => false,
-            'SameSite' => false
+            'SameSite' => null
         ];
 
         foreach (HeadersContextCookie::DIRECTIVE_NAMES as $name) {
@@ -93,7 +96,7 @@ public function cookie(string $name): Cookie
      *
      * @return Cookie
      */
-    public function permanentCookie($name): Cookie
+    public function permanentCookie(string $name): Cookie
     {
         $this->maxAge(self::FIVE_YEARS_IN_SEC);
         return $this->cookie($name);
@@ -108,7 +111,7 @@ public function permanentCookie($name): Cookie
      *
      * @return Cookie
      */
-    public function sessionCookie($name): Cookie
+    public function sessionCookie(string $name): Cookie
     {
         $this->httpOnly();
         $this->sameSite('Lax');

src/Cookie/Exception/CookieAlreadySentException.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 /*
  * This file is part of Polymorphine/Headers package.

src/Cookie/Exception/IllegalCharactersException.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 /*
  * This file is part of Polymorphine/Headers package.

src/Cookie/HeadersContextCookie.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 /*
  * This file is part of Polymorphine/Headers package.
@@ -21,12 +21,17 @@ class HeadersContextCookie implements Cookie
 {
     const DIRECTIVE_NAMES = ['Domain', 'Path', 'Expires', 'MaxAge', 'Secure', 'HttpOnly', 'SameSite'];
 
-    private $name;
-    private $directives;
-    private $headers;
+    private string          $name;
+    private array           $directives;
+    private ResponseHeaders $headers;
 
-    private $sent = false;
+    private bool $sent = false;
 
+    /**
+     * @param string          $name
+     * @param array           $directives
+     * @param ResponseHeaders $headers
+     */
     public function __construct(string $name, array $directives, ResponseHeaders $headers)
     {
         $this->name       = $this->validName($name);

src/Header.php

@@ -16,5 +16,10 @@
 
 interface Header
 {
+    /**
+     * @param MessageInterface $message
+     *
+     * @return MessageInterface New Message instance with modified headers
+     */
     public function addToMessage(MessageInterface $message): MessageInterface;
 }

src/Header/SetCookieHeader.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 /*
  * This file is part of Polymorphine/Headers package.
@@ -17,15 +17,18 @@
 
 class SetCookieHeader implements Header
 {
-    private $header;
+    private string $headerValue;
 
-    public function __construct(string $header)
+    /**
+     * @param string $headerValue
+     */
+    public function __construct(string $headerValue)
     {
-        $this->header = $header;
+        $this->headerValue = $headerValue;
     }
 
     public function addToMessage(MessageInterface $message): MessageInterface
     {
-        return $message->withAddedHeader('Set-Cookie', $this->header);
+        return $message->withAddedHeader('Set-Cookie', $this->headerValue);
     }
 }

src/ResponseHeaders.php

@@ -1,4 +1,4 @@
-<?php
+<?php declare(strict_types=1);
 
 /*
  * This file is part of Polymorphine/Headers package.
@@ -20,7 +20,7 @@
 
 final class ResponseHeaders implements MiddlewareInterface
 {
-    private $headers = [];
+    private array $headers;
 
     /**
      * @param Header[] $headers
@@ -39,11 +39,22 @@ public function process(ServerRequestInterface $request, RequestHandlerInterface
         return $response;
     }
 
+    /**
+     * Adds Header that will modify server Response.
+     *
+     * @param Header $header
+     */
     public function push(Header $header): void
     {
         $this->headers[] = $header;
     }
 
+    /**
+     * CookieSetup object can be used to configure Cookie header
+     * in server Response.
+     *
+     * @return CookieSetup
+     */
     public function cookieSetup(): CookieSetup
     {
         return new CookieSetup($this);

tests/Doubles/DummyServerRequest.php

@@ -0,0 +1,177 @@
+<?php declare(strict_types=1);
+
+/*
+ * This file is part of Polymorphine/Headers package.
+ *
+ * (c) Shudd3r <q3.shudder@gmail.com>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace Polymorphine\Headers\Tests\Doubles;
+
+use Psr\Http\Message\ServerRequestInterface;
+use Psr\Http\Message\StreamInterface;
+use Psr\Http\Message\UriInterface;
+
+
+class DummyServerRequest implements ServerRequestInterface
+{
+    public ?UriInterface $uri;
+
+    public function __construct(UriInterface $uri = null)
+    {
+        $this->uri = $uri;
+    }
+
+    public function getMethod(): string
+    {
+        return 'GET';
+    }
+
+    public function getUri(): UriInterface
+    {
+        return $this->uri;
+    }
+
+    public function getRequestTarget(): string
+    {
+        return 'foo?bar=baz';
+    }
+
+    public function getProtocolVersion(): string
+    {
+        return '1.1';
+    }
+
+    public function withProtocolVersion($version): self
+    {
+        return $this;
+    }
+
+    public function getHeaders(): array
+    {
+        return [];
+    }
+
+    public function hasHeader($name): bool
+    {
+        return false;
+    }
+
+    public function getHeader($name): array
+    {
+        return [];
+    }
+
+    public function getHeaderLine($name): string
+    {
+        return '';
+    }
+
+    public function withHeader($name, $value): self
+    {
+        return $this;
+    }
+
+    public function withAddedHeader($name, $value): self
+    {
+        return $this;
+    }
+
+    public function withoutHeader($name): self
+    {
+        return $this;
+    }
+
+    public function getBody(): StreamInterface
+    {
+        return new DummyStream();
+    }
+
+    public function withBody(StreamInterface $body): self
+    {
+        return $this;
+    }
+
+    public function withRequestTarget($requestTarget): self
+    {
+        return $this;
+    }
+
+    public function withMethod($method): self
+    {
+        return $this;
+    }
+
+    public function withUri(UriInterface $uri, $preserveHost = false): self
+    {
+        return $this;
+    }
+
+    public function getServerParams(): array
+    {
+        return [];
+    }
+
+    public function getCookieParams(): array
+    {
+        return [];
+    }
+
+    public function withCookieParams(array $cookies): self
+    {
+        return $this;
+    }
+
+    public function getQueryParams(): array
+    {
+        return [];
+    }
+
+    public function withQueryParams(array $query): self
+    {
+        return $this;
+    }
+
+    public function getUploadedFiles(): array
+    {
+        return [];
+    }
+
+    public function withUploadedFiles(array $uploadedFiles): self
+    {
+        return $this;
+    }
+
+    public function getParsedBody(): array
+    {
+        return [];
+    }
+
+    public function withParsedBody($data): self
+    {
+        return $this;
+    }
+
+    public function getAttributes(): array
+    {
+        return [];
+    }
+
+    public function getAttribute($name, $default = null)
+    {
+        return $default;
+    }
+
+    public function withAttribute($name, $value): self
+    {
+        return $this;
+    }
+
+    public function withoutAttribute($name): self
+    {
+        return $this;
+    }
+}