ExtendedParameter::__toString() - Code Metrics - Stadly/Http - Measure and Improve Code Quality continuously with Scrutinizer

ExtendedParameter::__toString() A
last analyzed 2023-09-22 08:55 UTC

↳ Parent: ExtendedParameter
Complexity

Conditions	1
Paths	1
Size

Total Lines	4
Code Lines	2
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	3
CRAP Score	1
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	1
eloc	2
c	1
b	0
f	0
nc	1
nop	0
dl	0
loc	4
ccs	3
cts	3
cp	1
crap	1
rs	10
<?php

declare(strict_types=1);

namespace Stadly\Http\Header\Value\ContentDisposition;

use InvalidArgumentException;
use Stadly\Http\Utilities\Rfc5987;
use Stadly\Http\Utilities\Rfc6266;

/**
 * Class for handling extended content disposition parameters.
 *
 * Specification: https://tools.ietf.org/html/rfc6266#section-4.1
 */
final class ExtendedParameter extends Parameter
{
    /**
     * @var string Character set.
     */
    private $charset;

    /**
     * @var string Language.
     */
    private $language;

    /**
     * Constructor.
     *
     * @param string $name Name. Usually `filename*`.
     * @param string $value Value.
     * @param string $charset Character set.
     * @param string $language Language.
     */
    public function __construct(string $name, string $value, string $charset = 'UTF-8', string $language = '')
    {
        // Value must be a string before setting the character set.
        $this->value = '';

        $this->setName($name);
        $this->setCharset($charset);
        $this->setValue($value);
        $this->setLanguage($language);
    }

    /**
     * Construct parameter from string.
     *
     * @param string $parameter Parameter string.
     * @return self Parameter generated based on the string.
     */
    public static function fromString(string $parameter): self
    {
        $regEx = '{^' . Rfc6266::DISPOSITION_PARM_EXTENDED_CAPTURE . '$}';
        $plainParameter = mb_convert_encoding($parameter, 'ISO-8859-1', 'UTF-8');
        if ($plainParameter !== $parameter || preg_match($regEx, $parameter, $matches) !== 1) {
            throw new InvalidArgumentException('Invalid parameter: ' . $parameter);
        }

        $value = self::decodeValue($matches['VALUE_CHARS'], $matches['CHARSET']);

        return new self($matches['NAME'], $value, $matches['CHARSET'], $matches['LANGUAGE']);
    }

    /**
     * @inheritDoc
     */
    public function __toString(): string
    {
        $value = self::encodeValue($this->value, $this->charset);
        return $this->name . '=' . $this->charset . "'" . $this->language . "'" . $value;
    }

    /**
     * @inheritDoc
     */
    public function setName(string $name): void
    {
        // Name must end with *.
        $plainName = mb_convert_encoding($name, 'ISO-8859-1', 'UTF-8');
        if ($plainName !== $name || preg_match('{^' . Rfc6266::EXT_TOKEN . '$}', $name) !== 1) {
            throw new InvalidArgumentException('Invalid name: ' . $name);
        }

        $this->name = $name;
    }

    /**
     * @inheritDoc
     */
    public function setValue(string $value): void
    {
        if (!self::canEncodeValue($value, $this->charset)) {
            throw new InvalidArgumentException(
                'Value incompatible with character set ' . $this->charset . ': ' . $value
            );
        }

        $this->value = $value;
    }

    /**
     * @return string Character set.
     */
    public function getCharset(): string
    {
        return $this->charset;
    }

    /**
     * @param string $charset Character set.
     */
    public function setCharset(string $charset = 'UTF-8'): void
    {
        $regEx = '{^' . Rfc5987::CHARSET . '$}';
        $plainCharset = mb_convert_encoding($charset, 'ISO-8859-1', 'UTF-8');
        if ($plainCharset !== $charset || preg_match($regEx, $charset) !== 1) {
            throw new InvalidArgumentException('Invalid character set: ' . $charset);
        }

        if (!in_array(strtolower($charset), array_map('strtolower', mb_list_encodings()), /*strict*/true)) {
            throw new InvalidArgumentException('Unsupported character set' . $charset);
        }

        if (!self::canEncodeValue($this->value, $charset)) {
            throw new InvalidArgumentException(
                'Value incompatible with character set ' . $charset . ': ' . $this->value
            );
        }

        $this->charset = $charset;
    }

    /**
     * @return string Language.
     */
    public function getLanguage(): string
    {
        return $this->language;
    }

    /**
     * @param string $language Language.
     */
    public function setLanguage(string $language): void
    {
        // Language can be empty.
        $plainLanguage = mb_convert_encoding($language, 'ISO-8859-1', 'UTF-8');
        if ($plainLanguage !== $language || preg_match('{^' . Rfc5987::LANGUAGE . '?$}', $language) !== 1) {
            throw new InvalidArgumentException('Invalid language: ' . $language);
        }

        $this->language = $language;
    }

    /**
     * Check if a value can be encoded using a character set.
     *
     * @param string $value Value to encode.
     * @param string $charset Character set.
     * @return bool Whether the value can be encoded using the character set.
     */
    private static function canEncodeValue(string $value, string $charset): bool
    {
        $convertedValue = mb_convert_encoding($value, $charset);
        return mb_convert_encoding($convertedValue, mb_internal_encoding(), $charset) === $value;
        return mb_convert_encoding($convertedValue, /** @scrutinizer ignore-type */ mb_internal_encoding(), $charset) === $value;
    }

    /**
     * @param string $value Value.
     * @param string $charset Character set.
     * @return string Encoded value.
     */
    private static function encodeValue(string $value, string $charset): string
    {
        return rawurlencode(mb_convert_encoding($value, $charset));
        return rawurlencode(/** @scrutinizer ignore-type */ mb_convert_encoding($value, $charset));
    }

    /**
     * @param string $value Value.
     * @param string $charset Character set.
     * @return string Decoded value.
     */
    private static function decodeValue(string $value, string $charset): string
    {
        if (!in_array(strtolower($charset), array_map('strtolower', mb_list_encodings()), /*strict*/true)) {
            throw new InvalidArgumentException('Unsupported character set' . $charset);
        }

        return mb_convert_encoding(rawurldecode($value), mb_internal_encoding(), $charset);
        return mb_convert_encoding(rawurldecode($value), /** @scrutinizer ignore-type */ mb_internal_encoding(), $charset);
    }
}

Stadly / Http

ExtendedParameter::__toString() A last analyzed 2023-09-22 08:55 UTC

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like

ExtendedParameter::__toString() A
last analyzed 2023-09-22 08:55 UTC
