Enjoyzz / cookie

src/Cookie.php

<?php

declare(strict_types=1);

namespace Enjoys\Cookie;

class Cookie
{
    public function __construct(private Options $options)
    {
    }


    /**
     * @param string|null $key
     * @return array<string,string>|string|null
     */
    public function get(?string $key = null): null|array|string
    {
        /** @var string[] $cookie */
        $cookie = $this->options->getRequest()->getCookieParams();
        if ($key === null) {
            return $cookie;
        }

        return $cookie[$key] ?? null;
    }


    public function has(string $key): bool
    {
        return array_key_exists($key, $this->options->getRequest()->getCookieParams());
    }


    /**
     * @throws NotCorrectTtlString
     */
    public function delete(string $name): void
    {
        if ($this->set($name, '', '-1 day')) {
            /** @var array<string, string> $cookie */
            $cookie = $this->options->getRequest()->getCookieParams();
            unset($cookie[$name]);
            $this->options->setRequest($this->options->getRequest()->withCookieParams($cookie));
        }
    }


    /**
     * @param array{path?: string, domain?: string, secure?: bool, httponly?: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'} $addedOptions

The doc comment array{path?: string, domain?: string, secure?: bool, httponly?: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'} at position 20 could not be parsed: Unknown type name ''Lax'' at position 20 in array{path?: string, domain?: string, secure?: bool, httponly?: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'}.

     * @throws NotCorrectTtlString
     * @see https://www.php.net/manual/ru/function.setcookie.php
     */
    public function set(
        string $key,
        string $value,
        bool|int|string|\DateTimeInterface $ttl = true,
        array $addedOptions = []
    ): bool {
        $setParams = $this->getSetParams($key, $value, $ttl, $addedOptions);

        /**
         * @psalm-suppress InvalidArgument, MixedArgument
         */
        if (setcookie(...$setParams)) {

It seems like $setParams can also be of type array; however, parameter $name of setcookie() does only seem to accept string, maybe add an additional type check?

            if ($setParams[2]['expires'] < 0) {
                return true;
            }
            $this->options->setRequest(
                $this->options->getRequest()->withCookieParams(
                    array_merge(
                        $this->options->getRequest()->getCookieParams(),
                        [
                            $key => urlencode($value)
                        ]
                    )
                )
            );
            return true;
        }
        return false;
    }

    /**
     * Отправляет cookie без URL-кодирования значения
     * @param array{path?: string, domain?: string, secure?: bool, httponly?: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'} $addedOptions

The doc comment array{path?: string, domain?: string, secure?: bool, httponly?: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'} at position 20 could not be parsed: Unknown type name ''Lax'' at position 20 in array{path?: string, domain?: string, secure?: bool, httponly?: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'}.

     * @throws NotCorrectTtlString
     * @see https://www.php.net/manual/ru/function.setrawcookie.php
     */
    public function setRaw(
        string $key,
        string $value,
        bool|int|string|\DateTimeInterface $ttl = true,
        array $addedOptions = []
    ): bool {
        $setParams = $this->getSetParams($key, $value, $ttl, $addedOptions);

        /**
         * @psalm-suppress InvalidArgument, MixedArgument
         */
        if (setrawcookie(...$setParams)) {

It seems like $setParams can also be of type array; however, parameter $name of setrawcookie() does only seem to accept string, maybe add an additional type check?

            if ($setParams[2]['expires'] < 0) {
                return true;
            }
            $this->options->setRequest(
                $this->options->getRequest()->withCookieParams(
                    array_merge(
                        $this->options->getRequest()->getCookieParams(),
                        [
                            $key => $value
                        ]
                    )
                )
            );
            return true;
        }


        return false;
    }

    /**
     * @param array{path?: string, domain?: string, secure?: bool, httponly?: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'} $addedOptions

The doc comment array{path?: string, domain?: string, secure?: bool, httponly?: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'} at position 20 could not be parsed: Unknown type name ''Lax'' at position 20 in array{path?: string, domain?: string, secure?: bool, httponly?: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'}.

     * @return array{string, string, array{expires: int, path: string, domain: string, secure: bool, httponly: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'}}

The doc comment array{string, string, array{expires: int, path: string, domain: string, secure: bool, httponly: bool, samesite?: 'Lax'|'lax'|'None'|'none'|'Strict'|'strict'}} at position 2 could not be parsed: Expected ':' at position 2, but found 'string'.

     * @throws NotCorrectTtlString
     */
    private function getSetParams(
        string $key,
        string $value,
        bool|int|string|\DateTimeInterface $ttl,
        array $addedOptions = []
    ): array {
        $expires = new Expires($ttl);
        $this->options->setExpires($expires->getExpires());

        return [$key, $value, $this->options->getOptions($addedOptions)];
    }
}