package and depencies

2023-01-08 02:57:24 +05:30
parent d5332eb421
commit 1d54b8bc7f
4309 changed files with 193331 additions and 172289 deletions
--- a/vendor/symfony/http-foundation/Request.php
+++ b/vendor/symfony/http-foundation/Request.php
@@ -48,8 +48,6 @@ class Request
    public const HEADER_X_FORWARDED_PORT = 0b010000;
    public const HEADER_X_FORWARDED_PREFIX = 0b100000;

-    /** @deprecated since Symfony 5.2, use either "HEADER_X_FORWARDED_FOR | HEADER_X_FORWARDED_HOST | HEADER_X_FORWARDED_PORT | HEADER_X_FORWARDED_PROTO" or "HEADER_X_FORWARDED_AWS_ELB" or "HEADER_X_FORWARDED_TRAEFIK" constants instead. */
-    public const HEADER_X_FORWARDED_ALL = 0b1011110; // All "X-Forwarded-*" headers sent by "usual" reverse proxy
    public const HEADER_X_FORWARDED_AWS_ELB = 0b0011010; // AWS ELB doesn't send X-Forwarded-Host
    public const HEADER_X_FORWARDED_TRAEFIK = 0b0111110; // All "X-Forwarded-*" headers sent by Traefik reverse proxy

@@ -136,22 +134,22 @@ class Request
    protected $content;

    /**
-     * @var array
+     * @var string[]
     */
    protected $languages;

    /**
-     * @var array
+     * @var string[]
     */
    protected $charsets;

    /**
-     * @var array
+     * @var string[]
     */
    protected $encodings;

    /**
-     * @var array
+     * @var string[]
     */
    protected $acceptableContentTypes;

@@ -201,25 +199,18 @@ class Request
    protected $defaultLocale = 'en';

    /**
-     * @var array
+     * @var array<string, string[]>
     */
    protected static $formats;

    protected static $requestFactory;

-    /**
-     * @var string|null
-     */
-    private $preferredFormat;
-    private $isHostValid = true;
-    private $isForwardedValid = true;
+    private ?string $preferredFormat = null;
+    private bool $isHostValid = true;
+    private bool $isForwardedValid = true;
+    private bool $isSafeContentPreferred;

-    /**
-     * @var bool|null
-     */
-    private $isSafeContentPreferred;
-
-    private static $trustedHeaderSet = -1;
+    private static int $trustedHeaderSet = -1;

    private const FORWARDED_PARAMS = [
        self::HEADER_X_FORWARDED_FOR => 'for',
@@ -298,10 +289,8 @@ class Request

    /**
     * Creates a new request with values from PHP's super globals.
-     *
-     * @return static
     */
-    public static function createFromGlobals()
+    public static function createFromGlobals(): static
    {
        $request = self::createRequestFromFactory($_GET, $_POST, [], $_COOKIE, $_FILES, $_SERVER);

@@ -328,10 +317,8 @@ class Request
     * @param array                $files      The request files ($_FILES)
     * @param array                $server     The server parameters ($_SERVER)
     * @param string|resource|null $content    The raw body data
-     *
-     * @return static
     */
-    public static function create(string $uri, string $method = 'GET', array $parameters = [], array $cookies = [], array $files = [], array $server = [], $content = null)
+    public static function create(string $uri, string $method = 'GET', array $parameters = [], array $cookies = [], array $files = [], array $server = [], $content = null): static
    {
        $server = array_replace([
            'SERVER_NAME' => 'localhost',
@@ -445,10 +432,8 @@ class Request
     * @param array $cookies    The COOKIE parameters
     * @param array $files      The FILES parameters
     * @param array $server     The SERVER parameters
-     *
-     * @return static
     */
-    public function duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null)
+    public function duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null): static
    {
        $dup = clone $this;
        if (null !== $query) {
@@ -509,12 +494,7 @@ class Request
        $this->headers = clone $this->headers;
    }

-    /**
-     * Returns the request as a string.
-     *
-     * @return string
-     */
-    public function __toString()
+    public function __toString(): string
    {
        $content = $this->getContent();

@@ -584,9 +564,6 @@ class Request
     */
    public static function setTrustedProxies(array $proxies, int $trustedHeaderSet)
    {
-        if (self::HEADER_X_FORWARDED_ALL === $trustedHeaderSet) {
-            trigger_deprecation('symfony/http-foundation', '5.2', 'The "HEADER_X_FORWARDED_ALL" constant is deprecated, use either "HEADER_X_FORWARDED_FOR | HEADER_X_FORWARDED_HOST | HEADER_X_FORWARDED_PORT | HEADER_X_FORWARDED_PROTO" or "HEADER_X_FORWARDED_AWS_ELB" or "HEADER_X_FORWARDED_TRAEFIK" constants instead.');
-        }
        self::$trustedProxies = array_reduce($proxies, function ($proxies, $proxy) {
            if ('REMOTE_ADDR' !== $proxy) {
                $proxies[] = $proxy;
@@ -602,9 +579,9 @@ class Request
    /**
     * Gets the list of trusted proxies.
     *
-     * @return array
+     * @return string[]
     */
-    public static function getTrustedProxies()
+    public static function getTrustedProxies(): array
    {
        return self::$trustedProxies;
    }
@@ -614,7 +591,7 @@ class Request
     *
     * @return int A bit field of Request::HEADER_* that defines which headers are trusted from your proxies
     */
-    public static function getTrustedHeaderSet()
+    public static function getTrustedHeaderSet(): int
    {
        return self::$trustedHeaderSet;
    }
@@ -638,9 +615,9 @@ class Request
    /**
     * Gets the list of trusted host patterns.
     *
-     * @return array
+     * @return string[]
     */
-    public static function getTrustedHosts()
+    public static function getTrustedHosts(): array
    {
        return self::$trustedHostPatterns;
    }
@@ -650,10 +627,8 @@ class Request
     *
     * It builds a normalized query string, where keys/value pairs are alphabetized,
     * have consistent escaping and unneeded delimiters are removed.
-     *
-     * @return string
     */
-    public static function normalizeQueryString(?string $qs)
+    public static function normalizeQueryString(?string $qs): string
    {
        if ('' === ($qs ?? '')) {
            return '';
@@ -683,10 +658,8 @@ class Request

    /**
     * Checks whether support for the _method request parameter is enabled.
-     *
-     * @return bool
     */
-    public static function getHttpMethodParameterOverride()
+    public static function getHttpMethodParameterOverride(): bool
    {
        return self::$httpMethodParameterOverride;
    }
@@ -700,13 +673,9 @@ class Request
     *
     * Order of precedence: PATH (routing placeholders or custom attributes), GET, POST
     *
-     * @param mixed $default The default value if the parameter key does not exist
-     *
-     * @return mixed
-     *
-     * @internal since Symfony 5.4, use explicit input sources instead
+     * @internal use explicit input sources instead
     */
-    public function get(string $key, $default = null)
+    public function get(string $key, mixed $default = null): mixed
    {
        if ($this !== $result = $this->attributes->get($key, $this)) {
            return $result;
@@ -726,9 +695,9 @@ class Request
    /**
     * Gets the Session.
     *
-     * @return SessionInterface
+     * @throws SessionNotFoundException When session is not set properly
     */
-    public function getSession()
+    public function getSession(): SessionInterface
    {
        $session = $this->session;
        if (!$session instanceof SessionInterface && null !== $session) {
@@ -745,10 +714,8 @@ class Request
    /**
     * Whether the request contains a Session which was started in one of the
     * previous requests.
-     *
-     * @return bool
     */
-    public function hasPreviousSession()
+    public function hasPreviousSession(): bool
    {
        // the check for $this->session avoids malicious users trying to fake a session cookie with proper name
        return $this->hasSession() && $this->cookies->has($this->getSession()->getName());
@@ -762,13 +729,9 @@ class Request
     * is associated with a Session instance.
     *
     * @param bool $skipIfUninitialized When true, ignores factories injected by `setSessionFactory`
-     *
-     * @return bool
     */
-    public function hasSession(/* bool $skipIfUninitialized = false */)
+    public function hasSession(bool $skipIfUninitialized = false): bool
    {
-        $skipIfUninitialized = \func_num_args() > 0 ? func_get_arg(0) : false;
-
        return null !== $this->session && (!$skipIfUninitialized || $this->session instanceof SessionInterface);
    }

@@ -796,11 +759,9 @@ class Request
     *
     * Use this method carefully; you should use getClientIp() instead.
     *
-     * @return array
-     *
     * @see getClientIp()
     */
-    public function getClientIps()
+    public function getClientIps(): array
    {
        $ip = $this->server->get('REMOTE_ADDR');

@@ -824,12 +785,10 @@ class Request
     * ("Client-Ip" for instance), configure it via the $trustedHeaderSet
     * argument of the Request::setTrustedProxies() method instead.
     *
-     * @return string|null
-     *
     * @see getClientIps()
     * @see https://wikipedia.org/wiki/X-Forwarded-For
     */
-    public function getClientIp()
+    public function getClientIp(): ?string
    {
        $ipAddresses = $this->getClientIps();

@@ -838,10 +797,8 @@ class Request

    /**
     * Returns current script name.
-     *
-     * @return string
     */
-    public function getScriptName()
+    public function getScriptName(): string
    {
        return $this->server->get('SCRIPT_NAME', $this->server->get('ORIG_SCRIPT_NAME', ''));
    }
@@ -860,13 +817,9 @@ class Request
     *
     * @return string The raw path (i.e. not urldecoded)
     */
-    public function getPathInfo()
+    public function getPathInfo(): string
    {
-        if (null === $this->pathInfo) {
-            $this->pathInfo = $this->preparePathInfo();
-        }
-
-        return $this->pathInfo;
+        return $this->pathInfo ??= $this->preparePathInfo();
    }

    /**
@@ -881,13 +834,9 @@ class Request
     *
     * @return string The raw path (i.e. not urldecoded)
     */
-    public function getBasePath()
+    public function getBasePath(): string
    {
-        if (null === $this->basePath) {
-            $this->basePath = $this->prepareBasePath();
-        }
-
-        return $this->basePath;
+        return $this->basePath ??= $this->prepareBasePath();
    }

    /**
@@ -900,7 +849,7 @@ class Request
     *
     * @return string The raw URL (i.e. not urldecoded)
     */
-    public function getBaseUrl()
+    public function getBaseUrl(): string
    {
        $trustedPrefix = '';

@@ -920,19 +869,13 @@ class Request
     */
    private function getBaseUrlReal(): string
    {
-        if (null === $this->baseUrl) {
-            $this->baseUrl = $this->prepareBaseUrl();
-        }
-
-        return $this->baseUrl;
+        return $this->baseUrl ??= $this->prepareBaseUrl();
    }

    /**
     * Gets the request's scheme.
-     *
-     * @return string
     */
-    public function getScheme()
+    public function getScheme(): string
    {
        return $this->isSecure() ? 'https' : 'http';
    }
@@ -947,7 +890,7 @@ class Request
     *
     * @return int|string|null Can be a string if fetched from the server bag
     */
-    public function getPort()
+    public function getPort(): int|string|null
    {
        if ($this->isFromTrustedProxy() && $host = $this->getTrustedValues(self::HEADER_X_FORWARDED_PORT)) {
            $host = $host[0];
@@ -972,20 +915,16 @@ class Request

    /**
     * Returns the user.
-     *
-     * @return string|null
     */
-    public function getUser()
+    public function getUser(): ?string
    {
        return $this->headers->get('PHP_AUTH_USER');
    }

    /**
     * Returns the password.
-     *
-     * @return string|null
     */
-    public function getPassword()
+    public function getPassword(): ?string
    {
        return $this->headers->get('PHP_AUTH_PW');
    }
@@ -995,7 +934,7 @@ class Request
     *
     * @return string|null A user name if any and, optionally, scheme-specific information about how to gain authorization to access the server
     */
-    public function getUserInfo()
+    public function getUserInfo(): ?string
    {
        $userinfo = $this->getUser();

@@ -1011,15 +950,13 @@ class Request
     * Returns the HTTP host being requested.
     *
     * The port name will be appended to the host if it's non-standard.
-     *
-     * @return string
     */
-    public function getHttpHost()
+    public function getHttpHost(): string
    {
        $scheme = $this->getScheme();
        $port = $this->getPort();

-        if (('http' == $scheme && 80 == $port) || ('https' == $scheme && 443 == $port)) {
+        if (('http' === $scheme && 80 == $port) || ('https' === $scheme && 443 == $port)) {
            return $this->getHost();
        }

@@ -1031,13 +968,9 @@ class Request
     *
     * @return string The raw URI (i.e. not URI decoded)
     */
-    public function getRequestUri()
+    public function getRequestUri(): string
    {
-        if (null === $this->requestUri) {
-            $this->requestUri = $this->prepareRequestUri();
-        }
-
-        return $this->requestUri;
+        return $this->requestUri ??= $this->prepareRequestUri();
    }

    /**
@@ -1045,10 +978,8 @@ class Request
     *
     * If the URL was called with basic authentication, the user
     * and the password are not added to the generated string.
-     *
-     * @return string
     */
-    public function getSchemeAndHttpHost()
+    public function getSchemeAndHttpHost(): string
    {
        return $this->getScheme().'://'.$this->getHttpHost();
    }
@@ -1056,11 +987,9 @@ class Request
    /**
     * Generates a normalized URI (URL) for the Request.
     *
-     * @return string
-     *
     * @see getQueryString()
     */
-    public function getUri()
+    public function getUri(): string
    {
        if (null !== $qs = $this->getQueryString()) {
            $qs = '?'.$qs;
@@ -1073,10 +1002,8 @@ class Request
     * Generates a normalized URI for the given path.
     *
     * @param string $path A path to use instead of the current one
-     *
-     * @return string
     */
-    public function getUriForPath(string $path)
+    public function getUriForPath(string $path): string
    {
        return $this->getSchemeAndHttpHost().$this->getBaseUrl().$path;
    }
@@ -1095,10 +1022,8 @@ class Request
     * - "/a/b/"        -> "../"
     * - "/a/b/c/other" -> "other"
     * - "/a/x/y"       -> "../../x/y"
-     *
-     * @return string
     */
-    public function getRelativeUriForPath(string $path)
+    public function getRelativeUriForPath(string $path): string
    {
        // be sure that we are dealing with an absolute path
        if (!isset($path[0]) || '/' !== $path[0]) {
@@ -1139,10 +1064,8 @@ class Request
     *
     * It builds a normalized query string, where keys/value pairs are alphabetized
     * and have consistent escaping.
-     *
-     * @return string|null
     */
-    public function getQueryString()
+    public function getQueryString(): ?string
    {
        $qs = static::normalizeQueryString($this->server->get('QUERY_STRING'));

@@ -1156,10 +1079,8 @@ class Request
     * when trusted proxies were set via "setTrustedProxies()".
     *
     * The "X-Forwarded-Proto" header must contain the protocol: "https" or "http".
-     *
-     * @return bool
     */
-    public function isSecure()
+    public function isSecure(): bool
    {
        if ($this->isFromTrustedProxy() && $proto = $this->getTrustedValues(self::HEADER_X_FORWARDED_PROTO)) {
            return \in_array(strtolower($proto[0]), ['https', 'on', 'ssl', '1'], true);
@@ -1178,11 +1099,9 @@ class Request
     *
     * The "X-Forwarded-Host" header must contain the client host name.
     *
-     * @return string
-     *
     * @throws SuspiciousOperationException when the host name is invalid or not trusted
     */
-    public function getHost()
+    public function getHost(): string
    {
        if ($this->isFromTrustedProxy() && $host = $this->getTrustedValues(self::HEADER_X_FORWARDED_HOST)) {
            $host = $host[0];
@@ -1254,11 +1173,9 @@ class Request
     *
     * The method is always an uppercased string.
     *
-     * @return string
-     *
     * @see getRealMethod()
     */
-    public function getMethod()
+    public function getMethod(): string
    {
        if (null !== $this->method) {
            return $this->method;
@@ -1296,21 +1213,17 @@ class Request
    /**
     * Gets the "real" request method.
     *
-     * @return string
-     *
     * @see getMethod()
     */
-    public function getRealMethod()
+    public function getRealMethod(): string
    {
        return strtoupper($this->server->get('REQUEST_METHOD', 'GET'));
    }

    /**
     * Gets the mime type associated with the format.
-     *
-     * @return string|null
     */
-    public function getMimeType(string $format)
+    public function getMimeType(string $format): ?string
    {
        if (null === static::$formats) {
            static::initializeFormats();
@@ -1322,9 +1235,9 @@ class Request
    /**
     * Gets the mime types associated with the format.
     *
-     * @return array
+     * @return string[]
     */
-    public static function getMimeTypes(string $format)
+    public static function getMimeTypes(string $format): array
    {
        if (null === static::$formats) {
            static::initializeFormats();
@@ -1335,10 +1248,8 @@ class Request

    /**
     * Gets the format associated with the mime type.
-     *
-     * @return string|null
     */
-    public function getFormat(?string $mimeType)
+    public function getFormat(?string $mimeType): ?string
    {
        $canonicalMimeType = null;
        if ($mimeType && false !== $pos = strpos($mimeType, ';')) {
@@ -1364,9 +1275,9 @@ class Request
    /**
     * Associates a format with mime types.
     *
-     * @param string|array $mimeTypes The associated mime types (the preferred one must be the first as it will be used as the content type)
+     * @param string|string[] $mimeTypes The associated mime types (the preferred one must be the first as it will be used as the content type)
     */
-    public function setFormat(?string $format, $mimeTypes)
+    public function setFormat(?string $format, string|array $mimeTypes)
    {
        if (null === static::$formats) {
            static::initializeFormats();
@@ -1385,14 +1296,10 @@ class Request
     *  * $default
     *
     * @see getPreferredFormat
-     *
-     * @return string|null
     */
-    public function getRequestFormat(?string $default = 'html')
+    public function getRequestFormat(?string $default = 'html'): ?string
    {
-        if (null === $this->format) {
-            $this->format = $this->attributes->get('_format');
-        }
+        $this->format ??= $this->attributes->get('_format');

        return $this->format ?? $default;
    }
@@ -1406,11 +1313,23 @@ class Request
    }

    /**
-     * Gets the format associated with the request.
+     * Gets the usual name of the format associated with the request's media type (provided in the Content-Type header).
     *
-     * @return string|null
+     * @deprecated since Symfony 6.2, use getContentTypeFormat() instead
     */
-    public function getContentType()
+    public function getContentType(): ?string
+    {
+        trigger_deprecation('symfony/http-foundation', '6.2', 'The "%s()" method is deprecated, use "getContentTypeFormat()" instead.', __METHOD__);
+
+        return $this->getContentTypeFormat();
+    }
+
+    /**
+     * Gets the usual name of the format associated with the request's media type (provided in the Content-Type header).
+     *
+     * @see Request::$formats
+     */
+    public function getContentTypeFormat(): ?string
    {
        return $this->getFormat($this->headers->get('CONTENT_TYPE', ''));
    }
@@ -1429,10 +1348,8 @@ class Request

    /**
     * Get the default locale.
-     *
-     * @return string
     */
-    public function getDefaultLocale()
+    public function getDefaultLocale(): string
    {
        return $this->defaultLocale;
    }
@@ -1447,10 +1364,8 @@ class Request

    /**
     * Get the locale.
-     *
-     * @return string
     */
-    public function getLocale()
+    public function getLocale(): string
    {
        return null === $this->locale ? $this->defaultLocale : $this->locale;
    }
@@ -1459,10 +1374,8 @@ class Request
     * Checks if the request method is of specified type.
     *
     * @param string $method Uppercase request method (GET, POST etc)
-     *
-     * @return bool
     */
-    public function isMethod(string $method)
+    public function isMethod(string $method): bool
    {
        return $this->getMethod() === strtoupper($method);
    }
@@ -1471,20 +1384,16 @@ class Request
     * Checks whether or not the method is safe.
     *
     * @see https://tools.ietf.org/html/rfc7231#section-4.2.1
-     *
-     * @return bool
     */
-    public function isMethodSafe()
+    public function isMethodSafe(): bool
    {
        return \in_array($this->getMethod(), ['GET', 'HEAD', 'OPTIONS', 'TRACE']);
    }

    /**
     * Checks whether or not the method is idempotent.
-     *
-     * @return bool
     */
-    public function isMethodIdempotent()
+    public function isMethodIdempotent(): bool
    {
        return \in_array($this->getMethod(), ['HEAD', 'GET', 'PUT', 'DELETE', 'TRACE', 'OPTIONS', 'PURGE']);
    }
@@ -1493,10 +1402,8 @@ class Request
     * Checks whether the method is cacheable or not.
     *
     * @see https://tools.ietf.org/html/rfc7231#section-4.2.3
-     *
-     * @return bool
     */
-    public function isMethodCacheable()
+    public function isMethodCacheable(): bool
    {
        return \in_array($this->getMethod(), ['GET', 'HEAD']);
    }
@@ -1509,10 +1416,8 @@ class Request
     * server might be different. This returns the former (from the "Via" header)
     * if the proxy is trusted (see "setTrustedProxies()"), otherwise it returns
     * the latter (from the "SERVER_PROTOCOL" server parameter).
-     *
-     * @return string|null
     */
-    public function getProtocolVersion()
+    public function getProtocolVersion(): ?string
    {
        if ($this->isFromTrustedProxy()) {
            preg_match('~^(HTTP/)?([1-9]\.[0-9]) ~', $this->headers->get('Via') ?? '', $matches);
@@ -1531,6 +1436,7 @@ class Request
     * @param bool $asResource If true, a resource will be returned
     *
     * @return string|resource
+     * @psalm-return ($asResource is true ? resource : string)
     */
    public function getContent(bool $asResource = false)
    {
@@ -1574,25 +1480,19 @@ class Request
     * Gets the request body decoded as array, typically from a JSON payload.
     *
     * @throws JsonException When the body cannot be decoded to an array
-     *
-     * @return array
     */
-    public function toArray()
+    public function toArray(): array
    {
        if ('' === $content = $this->getContent()) {
            throw new JsonException('Request body is empty.');
        }

        try {
-            $content = json_decode($content, true, 512, \JSON_BIGINT_AS_STRING | (\PHP_VERSION_ID >= 70300 ? \JSON_THROW_ON_ERROR : 0));
+            $content = json_decode($content, true, 512, \JSON_BIGINT_AS_STRING | \JSON_THROW_ON_ERROR);
        } catch (\JsonException $e) {
            throw new JsonException('Could not decode request body.', $e->getCode(), $e);
        }

-        if (\PHP_VERSION_ID < 70300 && \JSON_ERROR_NONE !== json_last_error()) {
-            throw new JsonException('Could not decode request body: '.json_last_error_msg(), json_last_error());
-        }
-
        if (!\is_array($content)) {
            throw new JsonException(sprintf('JSON content was expected to decode to an array, "%s" returned.', get_debug_type($content)));
        }
@@ -1602,18 +1502,13 @@ class Request

    /**
     * Gets the Etags.
-     *
-     * @return array
     */
-    public function getETags()
+    public function getETags(): array
    {
        return preg_split('/\s*,\s*/', $this->headers->get('If-None-Match', ''), -1, \PREG_SPLIT_NO_EMPTY);
    }

-    /**
-     * @return bool
-     */
-    public function isNoCache()
+    public function isNoCache(): bool
    {
        return $this->headers->hasCacheControlDirective('no-cache') || 'no-cache' == $this->headers->get('Pragma');
    }
@@ -1645,10 +1540,8 @@ class Request
     * Returns the preferred language.
     *
     * @param string[] $locales An array of ordered available locales
-     *
-     * @return string|null
     */
-    public function getPreferredLanguage(array $locales = null)
+    public function getPreferredLanguage(array $locales = null): ?string
    {
        $preferredLanguages = $this->getLanguages();

@@ -1679,9 +1572,9 @@ class Request
    /**
     * Gets a list of languages acceptable by the client browser ordered in the user browser preferences.
     *
-     * @return array
+     * @return string[]
     */
-    public function getLanguages()
+    public function getLanguages(): array
    {
        if (null !== $this->languages) {
            return $this->languages;
@@ -1720,9 +1613,9 @@ class Request
    /**
     * Gets a list of charsets acceptable by the client browser in preferable order.
     *
-     * @return array
+     * @return string[]
     */
-    public function getCharsets()
+    public function getCharsets(): array
    {
        if (null !== $this->charsets) {
            return $this->charsets;
@@ -1734,9 +1627,9 @@ class Request
    /**
     * Gets a list of encodings acceptable by the client browser in preferable order.
     *
-     * @return array
+     * @return string[]
     */
-    public function getEncodings()
+    public function getEncodings(): array
    {
        if (null !== $this->encodings) {
            return $this->encodings;
@@ -1748,9 +1641,9 @@ class Request
    /**
     * Gets a list of content types acceptable by the client browser in preferable order.
     *
-     * @return array
+     * @return string[]
     */
-    public function getAcceptableContentTypes()
+    public function getAcceptableContentTypes(): array
    {
        if (null !== $this->acceptableContentTypes) {
            return $this->acceptableContentTypes;
@@ -1766,10 +1659,8 @@ class Request
     * It is known to work with common JavaScript frameworks:
     *
     * @see https://wikipedia.org/wiki/List_of_Ajax_frameworks#JavaScript
-     *
-     * @return bool
     */
-    public function isXmlHttpRequest()
+    public function isXmlHttpRequest(): bool
    {
        return 'XMLHttpRequest' == $this->headers->get('X-Requested-With');
    }
@@ -1781,7 +1672,7 @@ class Request
     */
    public function preferSafeContent(): bool
    {
-        if (null !== $this->isSafeContentPreferred) {
+        if (isset($this->isSafeContentPreferred)) {
            return $this->isSafeContentPreferred;
        }

@@ -1848,10 +1739,8 @@ class Request

    /**
     * Prepares the base URL.
-     *
-     * @return string
     */
-    protected function prepareBaseUrl()
+    protected function prepareBaseUrl(): string
    {
        $filename = basename($this->server->get('SCRIPT_FILENAME', ''));

@@ -1917,10 +1806,8 @@ class Request

    /**
     * Prepares the base path.
-     *
-     * @return string
     */
-    protected function prepareBasePath()
+    protected function prepareBasePath(): string
    {
        $baseUrl = $this->getBaseUrl();
        if (empty($baseUrl)) {
@@ -1943,10 +1830,8 @@ class Request

    /**
     * Prepares the path info.
-     *
-     * @return string
     */
-    protected function preparePathInfo()
+    protected function preparePathInfo(): string
    {
        if (null === ($requestUri = $this->getRequestUri())) {
            return '/';
@@ -2002,7 +1887,7 @@ class Request
            if (class_exists(\Locale::class, false)) {
                \Locale::setDefault($locale);
            }
-        } catch (\Exception $e) {
+        } catch (\Exception) {
        }
    }

@@ -2025,7 +1910,7 @@ class Request
        return null;
    }

-    private static function createRequestFromFactory(array $query = [], array $request = [], array $attributes = [], array $cookies = [], array $files = [], array $server = [], $content = null): self
+    private static function createRequestFromFactory(array $query = [], array $request = [], array $attributes = [], array $cookies = [], array $files = [], array $server = [], $content = null): static
    {
        if (self::$requestFactory) {
            $request = (self::$requestFactory)($query, $request, $attributes, $cookies, $files, $server, $content);
@@ -2045,10 +1930,8 @@ class Request
     *
     * This can be useful to determine whether or not to trust the
     * contents of a proxy-specific header.
-     *
-     * @return bool
     */
-    public function isFromTrustedProxy()
+    public function isFromTrustedProxy(): bool
    {
        return self::$trustedProxies && IpUtils::checkIp($this->server->get('REMOTE_ADDR', ''), self::$trustedProxies);
    }
@@ -2136,9 +2019,7 @@ class Request
                unset($clientIps[$key]);

                // Fallback to this when the client IP falls into the range of trusted proxies
-                if (null === $firstTrustedIp) {
-                    $firstTrustedIp = $clientIp;
-                }
+                $firstTrustedIp ??= $clientIp;
            }
        }