rector/vendor/symfony/http-foundation/HeaderUtils.php

<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace RectorPrefix20210716\Symfony\Component\HttpFoundation;

/**
 * HTTP header utility functions.
 *
 * @author Christian Schmidt <github@chsc.dk>
 */
class HeaderUtils
{
    public const DISPOSITION_ATTACHMENT = 'attachment';
    public const DISPOSITION_INLINE = 'inline';
    /**
     * This class should not be instantiated.
     */
    private function __construct()
    {
    }
    /**
     * Splits an HTTP header by one or more separators.
     *
     * Example:
     *
     *     HeaderUtils::split("da, en-gb;q=0.8", ",;")
     *     // => ['da'], ['en-gb', 'q=0.8']]
     *
     * @param string $separators List of characters to split on, ordered by
     *                           precedence, e.g. ",", ";=", or ",;="
     *
     * @return array Nested array with as many levels as there are characters in
     *               $separators
     * @param string $header
     */
    public static function split($header, $separators) : array
    {
        $quotedSeparators = \preg_quote($separators, '/');
        \preg_match_all('
            /
                (?!\\s)
                    (?:
                        # quoted-string
                        "(?:[^"\\\\]|\\\\.)*(?:"|\\\\|$)
                    |
                        # token
                        [^"' . $quotedSeparators . ']+
                    )+
                (?<!\\s)
            |
                # separator
                \\s*
                (?<separator>[' . $quotedSeparators . '])
                \\s*
            /x', \trim($header), $matches, \PREG_SET_ORDER);
        return self::groupParts($matches, $separators);
    }
    /**
     * Combines an array of arrays into one associative array.
     *
     * Each of the nested arrays should have one or two elements. The first
     * value will be used as the keys in the associative array, and the second
     * will be used as the values, or true if the nested array only contains one
     * element. Array keys are lowercased.
     *
     * Example:
     *
     *     HeaderUtils::combine([["foo", "abc"], ["bar"]])
     *     // => ["foo" => "abc", "bar" => true]
     * @param mixed[] $parts
     */
    public static function combine($parts) : array
    {
        $assoc = [];
        foreach ($parts as $part) {
            $name = \strtolower($part[0]);
            $value = $part[1] ?? \true;
            $assoc[$name] = $value;
        }
        return $assoc;
    }
    /**
     * Joins an associative array into a string for use in an HTTP header.
     *
     * The key and value of each entry are joined with "=", and all entries
     * are joined with the specified separator and an additional space (for
     * readability). Values are quoted if necessary.
     *
     * Example:
     *
     *     HeaderUtils::toString(["foo" => "abc", "bar" => true, "baz" => "a b c"], ",")
     *     // => 'foo=abc, bar, baz="a b c"'
     * @param mixed[] $assoc
     * @param string $separator
     */
    public static function toString($assoc, $separator) : string
    {
        $parts = [];
        foreach ($assoc as $name => $value) {
            if (\true === $value) {
                $parts[] = $name;
            } else {
                $parts[] = $name . '=' . self::quote($value);
            }
        }
        return \implode($separator . ' ', $parts);
    }
    /**
     * Encodes a string as a quoted string, if necessary.
     *
     * If a string contains characters not allowed by the "token" construct in
     * the HTTP specification, it is backslash-escaped and enclosed in quotes
     * to match the "quoted-string" construct.
     * @param string $s
     */
    public static function quote($s) : string
    {
        if (\preg_match('/^[a-z0-9!#$%&\'*.^_`|~-]+$/i', $s)) {
            return $s;
        }
        return '"' . \addcslashes($s, '"\\"') . '"';
    }
    /**
     * Decodes a quoted string.
     *
     * If passed an unquoted string that matches the "token" construct (as
     * defined in the HTTP specification), it is passed through verbatimly.
     * @param string $s
     */
    public static function unquote($s) : string
    {
        return \preg_replace('/\\\\(.)|"/', '$1', $s);
    }
    /**
     * Generates an HTTP Content-Disposition field-value.
     *
     * @param string $disposition      One of "inline" or "attachment"
     * @param string $filename         A unicode string
     * @param string $filenameFallback A string containing only ASCII characters that
     *                                 is semantically equivalent to $filename. If the filename is already ASCII,
     *                                 it can be omitted, or just copied from $filename
     *
     * @return string A string suitable for use as a Content-Disposition field-value
     *
     * @throws \InvalidArgumentException
     *
     * @see RFC 6266
     */
    public static function makeDisposition($disposition, $filename, $filenameFallback = '') : string
    {
        if (!\in_array($disposition, [self::DISPOSITION_ATTACHMENT, self::DISPOSITION_INLINE])) {
            throw new \InvalidArgumentException(\sprintf('The disposition must be either "%s" or "%s".', self::DISPOSITION_ATTACHMENT, self::DISPOSITION_INLINE));
        }
        if ('' === $filenameFallback) {
            $filenameFallback = $filename;
        }
        // filenameFallback is not ASCII.
        if (!\preg_match('/^[\\x20-\\x7e]*$/', $filenameFallback)) {
            throw new \InvalidArgumentException('The filename fallback must only contain ASCII characters.');
        }
        // percent characters aren't safe in fallback.
        if (\false !== \strpos($filenameFallback, '%')) {
            throw new \InvalidArgumentException('The filename fallback cannot contain the "%" character.');
        }
        // path separators aren't allowed in either.
        if (\false !== \strpos($filename, '/') || \false !== \strpos($filename, '\\') || \false !== \strpos($filenameFallback, '/') || \false !== \strpos($filenameFallback, '\\')) {
            throw new \InvalidArgumentException('The filename and the fallback cannot contain the "/" and "\\" characters.');
        }
        $params = ['filename' => $filenameFallback];
        if ($filename !== $filenameFallback) {
            $params['filename*'] = "utf-8''" . \rawurlencode($filename);
        }
        return $disposition . '; ' . self::toString($params, ';');
    }
    /**
     * Like parse_str(), but preserves dots in variable names.
     * @param string $query
     * @param bool $ignoreBrackets
     * @param string $separator
     */
    public static function parseQuery($query, $ignoreBrackets = \false, $separator = '&') : array
    {
        $q = [];
        foreach (\explode($separator, $query) as $v) {
            if (\false !== ($i = \strpos($v, "\0"))) {
                $v = \substr($v, 0, $i);
            }
            if (\false === ($i = \strpos($v, '='))) {
                $k = \urldecode($v);
                $v = '';
            } else {
                $k = \urldecode(\substr($v, 0, $i));
                $v = \substr($v, $i);
            }
            if (\false !== ($i = \strpos($k, "\0"))) {
                $k = \substr($k, 0, $i);
            }
            $k = \ltrim($k, ' ');
            if ($ignoreBrackets) {
                $q[$k][] = \urldecode(\substr($v, 1));
                continue;
            }
            if (\false === ($i = \strpos($k, '['))) {
                $q[] = \bin2hex($k) . $v;
            } else {
                $q[] = \bin2hex(\substr($k, 0, $i)) . \rawurlencode(\substr($k, $i)) . $v;
            }
        }
        if ($ignoreBrackets) {
            return $q;
        }
        \parse_str(\implode('&', $q), $q);
        $query = [];
        foreach ($q as $k => $v) {
            if (\false !== ($i = \strpos($k, '_'))) {
                $query[\substr_replace($k, \hex2bin(\substr($k, 0, $i)) . '[', 0, 1 + $i)] = $v;
            } else {
                $query[\hex2bin($k)] = $v;
            }
        }
        return $query;
    }
    private static function groupParts(array $matches, string $separators, bool $first = \true) : array
    {
        $separator = $separators[0];
        $partSeparators = \substr($separators, 1);
        $i = 0;
        $partMatches = [];
        $previousMatchWasSeparator = \false;
        foreach ($matches as $match) {
            if (!$first && $previousMatchWasSeparator && isset($match['separator']) && $match['separator'] === $separator) {
                $previousMatchWasSeparator = \true;
                $partMatches[$i][] = $match;
            } elseif (isset($match['separator']) && $match['separator'] === $separator) {
                $previousMatchWasSeparator = \true;
                ++$i;
            } else {
                $previousMatchWasSeparator = \false;
                $partMatches[$i][] = $match;
            }
        }
        $parts = [];
        if ($partSeparators) {
            foreach ($partMatches as $matches) {
                $parts[] = self::groupParts($matches, $partSeparators, \false);
            }
        } else {
            foreach ($partMatches as $matches) {
                $parts[] = self::unquote($matches[0][0]);
            }
            if (!$first && 2 < \count($parts)) {
                $parts = [$parts[0], \implode($separator, \array_slice($parts, 1))];
            }
        }
        return $parts;
    }
}