sop / jwx

lib/JWX/JWT/Header/JOSE.php

Indentation +47 added lines, -47 removed lines

@@ -15,54 +15,54 @@
  */
 class JOSE extends Header
 {
-    /**
-     * Constructor.
-     *
-     * @param Header ...$headers One or more headers to merge
-     */
-    public function __construct(Header ...$headers)
-    {
-        $params = [];
-        foreach ($headers as $header) {
-            foreach ($header->parameters() as $param) {
-                if (isset($params[$param->name()])) {
-                    throw new \UnexpectedValueException('Duplicate parameter.');
-                }
-                $params[$param->name()] = $param;
-            }
-        }
-        parent::__construct(...array_values($params));
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param Header ...$headers One or more headers to merge
+	 */
+	public function __construct(Header ...$headers)
+	{
+		$params = [];
+		foreach ($headers as $header) {
+			foreach ($header->parameters() as $param) {
+				if (isset($params[$param->name()])) {
+					throw new \UnexpectedValueException('Duplicate parameter.');
+				}
+				$params[$param->name()] = $param;
+			}
+		}
+		parent::__construct(...array_values($params));
+	}
 
-    /**
-     * Get self merged with another Header.
-     *
-     * @param Header $header
-     *
-     * @return self
-     */
-    public function withHeader(Header $header): self
-    {
-        return new self($this, $header);
-    }
+	/**
+	 * Get self merged with another Header.
+	 *
+	 * @param Header $header
+	 *
+	 * @return self
+	 */
+	public function withHeader(Header $header): self
+	{
+		return new self($this, $header);
+	}
 
-    /**
-     * Whether JOSE is for a JWS.
-     *
-     * @return bool
-     */
-    public function isJWS(): bool
-    {
-        return $this->hasAlgorithm() && !$this->hasEncryptionAlgorithm();
-    }
+	/**
+	 * Whether JOSE is for a JWS.
+	 *
+	 * @return bool
+	 */
+	public function isJWS(): bool
+	{
+		return $this->hasAlgorithm() && !$this->hasEncryptionAlgorithm();
+	}
 
-    /**
-     * Whether JOSE is for a JWE.
-     *
-     * @return bool
-     */
-    public function isJWE(): bool
-    {
-        return $this->hasEncryptionAlgorithm();
-    }
+	/**
+	 * Whether JOSE is for a JWE.
+	 *
+	 * @return bool
+	 */
+	public function isJWE(): bool
+	{
+		return $this->hasEncryptionAlgorithm();
+	}
 }

lib/JWX/JWT/Header/Header.php

Indentation +147 added lines, -147 removed lines

@@ -11,162 +11,162 @@
  */
 class Header implements \Countable, \IteratorAggregate
 {
-    use TypedHeader;
+	use TypedHeader;
 
-    /**
-     * Parameters.
-     *
-     * @var JWTParameter[]
-     */
-    protected $_parameters;
+	/**
+	 * Parameters.
+	 *
+	 * @var JWTParameter[]
+	 */
+	protected $_parameters;
 
-    /**
-     * Constructor.
-     *
-     * @param JWTParameter ...$params Parameters
-     */
-    public function __construct(JWTParameter ...$params)
-    {
-        $this->_parameters = [];
-        foreach ($params as $param) {
-            $this->_parameters[$param->name()] = $param;
-        }
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param JWTParameter ...$params Parameters
+	 */
+	public function __construct(JWTParameter ...$params)
+	{
+		$this->_parameters = [];
+		foreach ($params as $param) {
+			$this->_parameters[$param->name()] = $param;
+		}
+	}
 
-    /**
-     * Initialize from an array representing a JSON object.
-     *
-     * @param array $members
-     *
-     * @return self
-     */
-    public static function fromArray(array $members): self
-    {
-        $params = [];
-        foreach ($members as $name => $value) {
-            $params[] = JWTParameter::fromNameAndValue($name, $value);
-        }
-        return new self(...$params);
-    }
+	/**
+	 * Initialize from an array representing a JSON object.
+	 *
+	 * @param array $members
+	 *
+	 * @return self
+	 */
+	public static function fromArray(array $members): self
+	{
+		$params = [];
+		foreach ($members as $name => $value) {
+			$params[] = JWTParameter::fromNameAndValue($name, $value);
+		}
+		return new self(...$params);
+	}
 
-    /**
-     * Initialize from a JSON.
-     *
-     * @param string $json
-     *
-     * @throws \UnexpectedValueException
-     *
-     * @return self
-     */
-    public static function fromJSON(string $json): self
-    {
-        $members = json_decode($json, true, 32, JSON_BIGINT_AS_STRING);
-        if (!is_array($members)) {
-            throw new \UnexpectedValueException('Invalid JSON.');
-        }
-        return self::fromArray($members);
-    }
+	/**
+	 * Initialize from a JSON.
+	 *
+	 * @param string $json
+	 *
+	 * @throws \UnexpectedValueException
+	 *
+	 * @return self
+	 */
+	public static function fromJSON(string $json): self
+	{
+		$members = json_decode($json, true, 32, JSON_BIGINT_AS_STRING);
+		if (!is_array($members)) {
+			throw new \UnexpectedValueException('Invalid JSON.');
+		}
+		return self::fromArray($members);
+	}
 
-    /**
-     * Get self with parameters added.
-     *
-     * @param JWTParameter ...$param
-     *
-     * @return self
-     */
-    public function withParameters(JWTParameter ...$params): self
-    {
-        $obj = clone $this;
-        foreach ($params as $param) {
-            $obj->_parameters[$param->name()] = $param;
-        }
-        return $obj;
-    }
+	/**
+	 * Get self with parameters added.
+	 *
+	 * @param JWTParameter ...$param
+	 *
+	 * @return self
+	 */
+	public function withParameters(JWTParameter ...$params): self
+	{
+		$obj = clone $this;
+		foreach ($params as $param) {
+			$obj->_parameters[$param->name()] = $param;
+		}
+		return $obj;
+	}
 
-    /**
-     * Get all parameters.
-     *
-     * @return JWTParameter[]
-     */
-    public function parameters(): array
-    {
-        return $this->_parameters;
-    }
+	/**
+	 * Get all parameters.
+	 *
+	 * @return JWTParameter[]
+	 */
+	public function parameters(): array
+	{
+		return $this->_parameters;
+	}
 
-    /**
-     * Whether parameters are present.
-     *
-     * Returns false if any of the given parameters is not set.
-     *
-     * @param string ...$names Parameter names
-     *
-     * @return bool
-     */
-    public function has(string ...$names): bool
-    {
-        foreach ($names as $name) {
-            if (!isset($this->_parameters[$name])) {
-                return false;
-            }
-        }
-        return true;
-    }
+	/**
+	 * Whether parameters are present.
+	 *
+	 * Returns false if any of the given parameters is not set.
+	 *
+	 * @param string ...$names Parameter names
+	 *
+	 * @return bool
+	 */
+	public function has(string ...$names): bool
+	{
+		foreach ($names as $name) {
+			if (!isset($this->_parameters[$name])) {
+				return false;
+			}
+		}
+		return true;
+	}
 
-    /**
-     * Get a parameter.
-     *
-     * @param string $name Parameter name
-     *
-     * @throws \LogicException
-     *
-     * @return JWTParameter
-     */
-    public function get(string $name): JWTParameter
-    {
-        if (!$this->has($name)) {
-            throw new \LogicException("Parameter {$name} doesn't exists.");
-        }
-        return $this->_parameters[$name];
-    }
+	/**
+	 * Get a parameter.
+	 *
+	 * @param string $name Parameter name
+	 *
+	 * @throws \LogicException
+	 *
+	 * @return JWTParameter
+	 */
+	public function get(string $name): JWTParameter
+	{
+		if (!$this->has($name)) {
+			throw new \LogicException("Parameter {$name} doesn't exists.");
+		}
+		return $this->_parameters[$name];
+	}
 
-    /**
-     * Convert to a JSON.
-     *
-     * @return string
-     */
-    public function toJSON(): string
-    {
-        if (empty($this->_parameters)) {
-            return '';
-        }
-        $data = [];
-        foreach ($this->_parameters as $param) {
-            $data[$param->name()] = $param->value();
-        }
-        return json_encode((object) $data, JSON_UNESCAPED_SLASHES);
-    }
+	/**
+	 * Convert to a JSON.
+	 *
+	 * @return string
+	 */
+	public function toJSON(): string
+	{
+		if (empty($this->_parameters)) {
+			return '';
+		}
+		$data = [];
+		foreach ($this->_parameters as $param) {
+			$data[$param->name()] = $param->value();
+		}
+		return json_encode((object) $data, JSON_UNESCAPED_SLASHES);
+	}
 
-    /**
-     * Get the number of parameters.
-     *
-     * @see \Countable::count()
-     *
-     * @return int
-     */
-    public function count(): int
-    {
-        return count($this->_parameters);
-    }
+	/**
+	 * Get the number of parameters.
+	 *
+	 * @see \Countable::count()
+	 *
+	 * @return int
+	 */
+	public function count(): int
+	{
+		return count($this->_parameters);
+	}
 
-    /**
-     * Get iterator for the parameters.
-     *
-     * @see \IteratorAggregate::getIterator()
-     *
-     * @return \ArrayIterator
-     */
-    public function getIterator(): \ArrayIterator
-    {
-        return new \ArrayIterator($this->_parameters);
-    }
+	/**
+	 * Get iterator for the parameters.
+	 *
+	 * @see \IteratorAggregate::getIterator()
+	 *
+	 * @return \ArrayIterator
+	 */
+	public function getIterator(): \ArrayIterator
+	{
+		return new \ArrayIterator($this->_parameters);
+	}
 }

lib/JWX/JWT/Header/HeaderParameters.php

Indentation +6 added lines, -6 removed lines

@@ -11,10 +11,10 @@
  */
 interface HeaderParameters
 {
-    /**
-     * Get an array of JOSE header parameters representing this object.
-     *
-     * @return JWTParameter[]
-     */
-    public function headerParameters(): array;
+	/**
+	 * Get an array of JOSE header parameters representing this object.
+	 *
+	 * @return JWTParameter[]
+	 */
+	public function headerParameters(): array;
 }

lib/JWX/JWT/Header/TypedHeader.php

Indentation +472 added lines, -472 removed lines

@@ -13,476 +13,476 @@
  */
 trait TypedHeader
 {
-    /**
-     * Whether parameters are present.
-     *
-     * @param string ...$names Parameter names
-     *
-     * @return bool
-     */
-    abstract public function has(string ...$names): bool;
-
-    /**
-     * Get a parameter.
-     *
-     * @param string $name Parameter name
-     *
-     * @throws \LogicException If the parameter is not present
-     *
-     * @return JWTParameter
-     */
-    abstract public function get(string $name): JWTParameter;
-
-    /**
-     * Check whether the algorithm parameter is present.
-     *
-     * @return bool
-     */
-    public function hasAlgorithm(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_ALG);
-    }
-
-    /**
-     * Get the algorithm parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\AlgorithmParameter
-     */
-    public function algorithm(): Parameter\AlgorithmParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_ALG),
-            Parameter\AlgorithmParameter::class);
-    }
-
-    /**
-     * Check whether the authentication tag parameter is present.
-     *
-     * @return bool
-     */
-    public function hasAuthenticationTag(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_TAG);
-    }
-
-    /**
-     * Get the authentication tag parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\AuthenticationTagParameter
-     */
-    public function authenticationTag(): Parameter\AuthenticationTagParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_TAG),
-            Parameter\AuthenticationTagParameter::class);
-    }
-
-    /**
-     * Check whether the 'base64url-encode payload' parameter is present.
-     *
-     * @return bool
-     */
-    public function hasB64Payload(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_B64);
-    }
-
-    /**
-     * Get the 'base64url-encode payload' parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\B64PayloadParameter
-     */
-    public function B64Payload(): Parameter\B64PayloadParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_B64),
-            Parameter\B64PayloadParameter::class);
-    }
-
-    /**
-     * Check whether the compression algorithm parameter is present.
-     *
-     * @return bool
-     */
-    public function hasCompressionAlgorithm(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_ZIP);
-    }
-
-    /**
-     * Get the compression algorithm parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\CompressionAlgorithmParameter
-     */
-    public function compressionAlgorithm(): Parameter\CompressionAlgorithmParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_ZIP),
-            Parameter\CompressionAlgorithmParameter::class);
-    }
-
-    /**
-     * Check whether the content type parameter is present.
-     *
-     * @return bool
-     */
-    public function hasContentType(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_CTY);
-    }
-
-    /**
-     * Get the content type parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\ContentTypeParameter
-     */
-    public function contentType(): Parameter\ContentTypeParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_CTY),
-            Parameter\ContentTypeParameter::class);
-    }
-
-    /**
-     * Check whether the critical parameter is present.
-     *
-     * @return bool
-     */
-    public function hasCritical(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_CRIT);
-    }
-
-    /**
-     * Get the critical parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\CriticalParameter
-     */
-    public function critical(): Parameter\CriticalParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_CRIT),
-            Parameter\CriticalParameter::class);
-    }
-
-    /**
-     * Check whether the encryption algorithm parameter is present.
-     *
-     * @return bool
-     */
-    public function hasEncryptionAlgorithm(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_ENC);
-    }
-
-    /**
-     * Get the encryption algorithm parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\EncryptionAlgorithmParameter
-     */
-    public function encryptionAlgorithm(): Parameter\EncryptionAlgorithmParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_ENC),
-            Parameter\EncryptionAlgorithmParameter::class);
-    }
-
-    /**
-     * Check whether the initialization vector parameter is present.
-     *
-     * @return bool
-     */
-    public function hasInitializationVector(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_IV);
-    }
-
-    /**
-     * Get the initialization vector parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\InitializationVectorParameter
-     */
-    public function initializationVector(): Parameter\InitializationVectorParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_IV),
-            Parameter\InitializationVectorParameter::class);
-    }
-
-    /**
-     * Check whether the JSON web key parameter is present.
-     *
-     * @return bool
-     */
-    public function hasJSONWebKey(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_JWK);
-    }
-
-    /**
-     * Get the JSON web key parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\JSONWebKeyParameter
-     */
-    public function JSONWebKey(): Parameter\JSONWebKeyParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_JWK),
-            Parameter\JSONWebKeyParameter::class);
-    }
-
-    /**
-     * Check whether the JWK set URL parameter is present.
-     *
-     * @return bool
-     */
-    public function hasJWKSetURL(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_JKU);
-    }
-
-    /**
-     * Get the JWK set URL parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\JWKSetURLParameter
-     */
-    public function JWKSetURL(): Parameter\JWKSetURLParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_JKU),
-            Parameter\JWKSetURLParameter::class);
-    }
-
-    /**
-     * Check whether the key ID parameter is present.
-     *
-     * @return bool
-     */
-    public function hasKeyID(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_KID);
-    }
-
-    /**
-     * Get the key ID parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\KeyIDParameter
-     */
-    public function keyID(): Parameter\KeyIDParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_KID),
-            Parameter\KeyIDParameter::class);
-    }
-
-    /**
-     * Check whether the PBES2 count parameter is present.
-     *
-     * @return bool
-     */
-    public function hasPBES2Count(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_P2C);
-    }
-
-    /**
-     * Get the PBES2 count parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\PBES2CountParameter
-     */
-    public function PBES2Count(): Parameter\PBES2CountParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_P2C),
-            Parameter\PBES2CountParameter::class);
-    }
-
-    /**
-     * Check whether the PBES2 salt input parameter is present.
-     *
-     * @return bool
-     */
-    public function hasPBES2SaltInput(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_P2S);
-    }
-
-    /**
-     * Get the PBES2 salt input parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\PBES2SaltInputParameter
-     */
-    public function PBES2SaltInput(): Parameter\PBES2SaltInputParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_P2S),
-            Parameter\PBES2SaltInputParameter::class);
-    }
-
-    /**
-     * Check whether the type parameter is present.
-     *
-     * @return bool
-     */
-    public function hasType(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_TYP);
-    }
-
-    /**
-     * Get the type parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\TypeParameter
-     */
-    public function type(): Parameter\TypeParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_TYP),
-            Parameter\TypeParameter::class);
-    }
-
-    /**
-     * Check whether the X.509 certificate chain parameter is present.
-     *
-     * @return bool
-     */
-    public function hasX509CertificateChain(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_X5C);
-    }
-
-    /**
-     * Get the X.509 certificate chain parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\X509CertificateChainParameter
-     */
-    public function X509CertificateChain(): Parameter\X509CertificateChainParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_X5C),
-            Parameter\X509CertificateChainParameter::class);
-    }
-
-    /**
-     * Check whether the X.509 certificate SHA-1 thumbprint parameter is
-     * present.
-     *
-     * @return bool
-     */
-    public function hasX509CertificateSHA1Thumbprint(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_X5T);
-    }
-
-    /**
-     * Get the X.509 certificate SHA-1 thumbprint parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\X509CertificateSHA1ThumbprintParameter
-     */
-    public function X509CertificateSHA1Thumbprint(): Parameter\X509CertificateSHA1ThumbprintParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_X5T),
-            Parameter\X509CertificateSHA1ThumbprintParameter::class);
-    }
-
-    /**
-     * Check whether the X.509 certificate SHA-256 thumbprint parameter is
-     * present.
-     *
-     * @return bool
-     */
-    public function hasX509CertificateSHA256Thumbprint(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_X5TS256);
-    }
-
-    /**
-     * Get the X.509 certificate SHA-256 thumbprint parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\X509CertificateSHA256ThumbprintParameter
-     */
-    public function X509CertificateSHA256Thumbprint(): Parameter\X509CertificateSHA256ThumbprintParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_X5TS256),
-            Parameter\X509CertificateSHA256ThumbprintParameter::class);
-    }
-
-    /**
-     * Check whether the X.509 URL parameter is present.
-     *
-     * @return bool
-     */
-    public function hasX509URL(): bool
-    {
-        return $this->has(Parameter\JWTParameter::P_X5U);
-    }
-
-    /**
-     * Get the X.509 URL parameter.
-     *
-     * @throws \UnexpectedValueException If the parameter has a wrong class
-     * @throws \LogicException           If the parameter is not present
-     *
-     * @return \Sop\JWX\JWT\Parameter\X509URLParameter
-     */
-    public function X509URL(): Parameter\X509URLParameter
-    {
-        return self::_checkType($this->get(Parameter\JWTParameter::P_X5U),
-            Parameter\X509URLParameter::class);
-    }
-
-    /**
-     * Check that the parameter is an instance of the given class.
-     *
-     * @param \Sop\JWX\JWT\Parameter\JWTParameter $param Parameter
-     * @param string                              $cls   Class name
-     *
-     * @throws \UnexpectedValueException
-     *
-     * @return \Sop\JWX\JWT\Parameter\JWTParameter
-     */
-    private static function _checkType(Parameter\JWTParameter $param, string $cls): Parameter\JWTParameter
-    {
-        if (!$param instanceof $cls) {
-            throw new \UnexpectedValueException(
-                "{$cls} expected, got " . get_class($param));
-        }
-        return $param;
-    }
+	/**
+	 * Whether parameters are present.
+	 *
+	 * @param string ...$names Parameter names
+	 *
+	 * @return bool
+	 */
+	abstract public function has(string ...$names): bool;
+
+	/**
+	 * Get a parameter.
+	 *
+	 * @param string $name Parameter name
+	 *
+	 * @throws \LogicException If the parameter is not present
+	 *
+	 * @return JWTParameter
+	 */
+	abstract public function get(string $name): JWTParameter;
+
+	/**
+	 * Check whether the algorithm parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasAlgorithm(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_ALG);
+	}
+
+	/**
+	 * Get the algorithm parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\AlgorithmParameter
+	 */
+	public function algorithm(): Parameter\AlgorithmParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_ALG),
+			Parameter\AlgorithmParameter::class);
+	}
+
+	/**
+	 * Check whether the authentication tag parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasAuthenticationTag(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_TAG);
+	}
+
+	/**
+	 * Get the authentication tag parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\AuthenticationTagParameter
+	 */
+	public function authenticationTag(): Parameter\AuthenticationTagParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_TAG),
+			Parameter\AuthenticationTagParameter::class);
+	}
+
+	/**
+	 * Check whether the 'base64url-encode payload' parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasB64Payload(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_B64);
+	}
+
+	/**
+	 * Get the 'base64url-encode payload' parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\B64PayloadParameter
+	 */
+	public function B64Payload(): Parameter\B64PayloadParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_B64),
+			Parameter\B64PayloadParameter::class);
+	}
+
+	/**
+	 * Check whether the compression algorithm parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasCompressionAlgorithm(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_ZIP);
+	}
+
+	/**
+	 * Get the compression algorithm parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\CompressionAlgorithmParameter
+	 */
+	public function compressionAlgorithm(): Parameter\CompressionAlgorithmParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_ZIP),
+			Parameter\CompressionAlgorithmParameter::class);
+	}
+
+	/**
+	 * Check whether the content type parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasContentType(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_CTY);
+	}
+
+	/**
+	 * Get the content type parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\ContentTypeParameter
+	 */
+	public function contentType(): Parameter\ContentTypeParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_CTY),
+			Parameter\ContentTypeParameter::class);
+	}
+
+	/**
+	 * Check whether the critical parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasCritical(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_CRIT);
+	}
+
+	/**
+	 * Get the critical parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\CriticalParameter
+	 */
+	public function critical(): Parameter\CriticalParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_CRIT),
+			Parameter\CriticalParameter::class);
+	}
+
+	/**
+	 * Check whether the encryption algorithm parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasEncryptionAlgorithm(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_ENC);
+	}
+
+	/**
+	 * Get the encryption algorithm parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\EncryptionAlgorithmParameter
+	 */
+	public function encryptionAlgorithm(): Parameter\EncryptionAlgorithmParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_ENC),
+			Parameter\EncryptionAlgorithmParameter::class);
+	}
+
+	/**
+	 * Check whether the initialization vector parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasInitializationVector(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_IV);
+	}
+
+	/**
+	 * Get the initialization vector parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\InitializationVectorParameter
+	 */
+	public function initializationVector(): Parameter\InitializationVectorParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_IV),
+			Parameter\InitializationVectorParameter::class);
+	}
+
+	/**
+	 * Check whether the JSON web key parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasJSONWebKey(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_JWK);
+	}
+
+	/**
+	 * Get the JSON web key parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\JSONWebKeyParameter
+	 */
+	public function JSONWebKey(): Parameter\JSONWebKeyParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_JWK),
+			Parameter\JSONWebKeyParameter::class);
+	}
+
+	/**
+	 * Check whether the JWK set URL parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasJWKSetURL(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_JKU);
+	}
+
+	/**
+	 * Get the JWK set URL parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\JWKSetURLParameter
+	 */
+	public function JWKSetURL(): Parameter\JWKSetURLParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_JKU),
+			Parameter\JWKSetURLParameter::class);
+	}
+
+	/**
+	 * Check whether the key ID parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasKeyID(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_KID);
+	}
+
+	/**
+	 * Get the key ID parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\KeyIDParameter
+	 */
+	public function keyID(): Parameter\KeyIDParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_KID),
+			Parameter\KeyIDParameter::class);
+	}
+
+	/**
+	 * Check whether the PBES2 count parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasPBES2Count(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_P2C);
+	}
+
+	/**
+	 * Get the PBES2 count parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\PBES2CountParameter
+	 */
+	public function PBES2Count(): Parameter\PBES2CountParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_P2C),
+			Parameter\PBES2CountParameter::class);
+	}
+
+	/**
+	 * Check whether the PBES2 salt input parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasPBES2SaltInput(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_P2S);
+	}
+
+	/**
+	 * Get the PBES2 salt input parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\PBES2SaltInputParameter
+	 */
+	public function PBES2SaltInput(): Parameter\PBES2SaltInputParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_P2S),
+			Parameter\PBES2SaltInputParameter::class);
+	}
+
+	/**
+	 * Check whether the type parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasType(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_TYP);
+	}
+
+	/**
+	 * Get the type parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\TypeParameter
+	 */
+	public function type(): Parameter\TypeParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_TYP),
+			Parameter\TypeParameter::class);
+	}
+
+	/**
+	 * Check whether the X.509 certificate chain parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasX509CertificateChain(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_X5C);
+	}
+
+	/**
+	 * Get the X.509 certificate chain parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\X509CertificateChainParameter
+	 */
+	public function X509CertificateChain(): Parameter\X509CertificateChainParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_X5C),
+			Parameter\X509CertificateChainParameter::class);
+	}
+
+	/**
+	 * Check whether the X.509 certificate SHA-1 thumbprint parameter is
+	 * present.
+	 *
+	 * @return bool
+	 */
+	public function hasX509CertificateSHA1Thumbprint(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_X5T);
+	}
+
+	/**
+	 * Get the X.509 certificate SHA-1 thumbprint parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\X509CertificateSHA1ThumbprintParameter
+	 */
+	public function X509CertificateSHA1Thumbprint(): Parameter\X509CertificateSHA1ThumbprintParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_X5T),
+			Parameter\X509CertificateSHA1ThumbprintParameter::class);
+	}
+
+	/**
+	 * Check whether the X.509 certificate SHA-256 thumbprint parameter is
+	 * present.
+	 *
+	 * @return bool
+	 */
+	public function hasX509CertificateSHA256Thumbprint(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_X5TS256);
+	}
+
+	/**
+	 * Get the X.509 certificate SHA-256 thumbprint parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\X509CertificateSHA256ThumbprintParameter
+	 */
+	public function X509CertificateSHA256Thumbprint(): Parameter\X509CertificateSHA256ThumbprintParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_X5TS256),
+			Parameter\X509CertificateSHA256ThumbprintParameter::class);
+	}
+
+	/**
+	 * Check whether the X.509 URL parameter is present.
+	 *
+	 * @return bool
+	 */
+	public function hasX509URL(): bool
+	{
+		return $this->has(Parameter\JWTParameter::P_X5U);
+	}
+
+	/**
+	 * Get the X.509 URL parameter.
+	 *
+	 * @throws \UnexpectedValueException If the parameter has a wrong class
+	 * @throws \LogicException           If the parameter is not present
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\X509URLParameter
+	 */
+	public function X509URL(): Parameter\X509URLParameter
+	{
+		return self::_checkType($this->get(Parameter\JWTParameter::P_X5U),
+			Parameter\X509URLParameter::class);
+	}
+
+	/**
+	 * Check that the parameter is an instance of the given class.
+	 *
+	 * @param \Sop\JWX\JWT\Parameter\JWTParameter $param Parameter
+	 * @param string                              $cls   Class name
+	 *
+	 * @throws \UnexpectedValueException
+	 *
+	 * @return \Sop\JWX\JWT\Parameter\JWTParameter
+	 */
+	private static function _checkType(Parameter\JWTParameter $param, string $cls): Parameter\JWTParameter
+	{
+		if (!$param instanceof $cls) {
+			throw new \UnexpectedValueException(
+				"{$cls} expected, got " . get_class($param));
+		}
+		return $param;
+	}
 }

lib/JWX/Parameter/Feature/Base64URLValue.php

Indentation +46 added lines, -46 removed lines

@@ -12,54 +12,54 @@
  */
 trait Base64URLValue
 {
-    use StringParameterValue;
+	use StringParameterValue;
 
-    /**
-     * Get the parameter value.
-     *
-     * @return string
-     */
-    abstract public function value();
+	/**
+	 * Get the parameter value.
+	 *
+	 * @return string
+	 */
+	abstract public function value();
 
-    /**
-     * Initialize from native value.
-     *
-     * Value shall be encoded using Base64url encoding.
-     *
-     * @param string $value
-     *
-     * @return self
-     */
-    public static function fromString(string $value): Parameter
-    {
-        return new static(Base64::urlEncode($value));
-    }
+	/**
+	 * Initialize from native value.
+	 *
+	 * Value shall be encoded using Base64url encoding.
+	 *
+	 * @param string $value
+	 *
+	 * @return self
+	 */
+	public static function fromString(string $value): Parameter
+	{
+		return new static(Base64::urlEncode($value));
+	}
 
-    /**
-     * Get the parameter value as a decoded string.
-     *
-     * @return string
-     */
-    public function string(): string
-    {
-        return Base64::urlDecode($this->value());
-    }
+	/**
+	 * Get the parameter value as a decoded string.
+	 *
+	 * @return string
+	 */
+	public function string(): string
+	{
+		return Base64::urlDecode($this->value());
+	}
 
-    /**
-     * Validate that value is validly base64url encoded.
-     *
-     * @param string $value
-     *
-     * @throws \UnexpectedValueException
-     *
-     * @return self
-     */
-    protected function _validateEncoding(string $value)
-    {
-        if (!Base64::isValidURLEncoding($value)) {
-            throw new \UnexpectedValueException(
-                'Value must be base64url encoded.');
-        }
-        return $this;
-    }
+	/**
+	 * Validate that value is validly base64url encoded.
+	 *
+	 * @param string $value
+	 *
+	 * @throws \UnexpectedValueException
+	 *
+	 * @return self
+	 */
+	protected function _validateEncoding(string $value)
+	{
+		if (!Base64::isValidURLEncoding($value)) {
+			throw new \UnexpectedValueException(
+				'Value must be base64url encoded.');
+		}
+		return $this;
+	}
 }

lib/JWX/Parameter/Feature/ArrayParameterValue.php

Indentation +21 added lines, -21 removed lines

@@ -11,26 +11,26 @@
  */
 trait ArrayParameterValue
 {
-    /**
-     * Constructor.
-     *
-     * @param mixed ...$values
-     */
-    abstract public function __construct(...$values);
+	/**
+	 * Constructor.
+	 *
+	 * @param mixed ...$values
+	 */
+	abstract public function __construct(...$values);
 
-    /**
-     * Initialize from a JSON value.
-     *
-     * @param array $value
-     *
-     * @return static
-     */
-    public static function fromJSONValue($value): Parameter
-    {
-        if (!is_array($value)) {
-            throw new \UnexpectedValueException(
-                get_called_class() . ' expects an array parameter.');
-        }
-        return new static(...$value);
-    }
+	/**
+	 * Initialize from a JSON value.
+	 *
+	 * @param array $value
+	 *
+	 * @return static
+	 */
+	public static function fromJSONValue($value): Parameter
+	{
+		if (!is_array($value)) {
+			throw new \UnexpectedValueException(
+				get_called_class() . ' expects an array parameter.');
+		}
+		return new static(...$value);
+	}
 }

lib/JWX/Parameter/Feature/StringParameterValue.php

Indentation +17 added lines, -17 removed lines

@@ -11,22 +11,22 @@
  */
 trait StringParameterValue
 {
-    /**
-     * Constructor.
-     *
-     * @param string $value Parameter value
-     */
-    abstract public function __construct(string $value);
+	/**
+	 * Constructor.
+	 *
+	 * @param string $value Parameter value
+	 */
+	abstract public function __construct(string $value);
 
-    /**
-     * Initialize from a JSON value.
-     *
-     * @param string $value
-     *
-     * @return static
-     */
-    public static function fromJSONValue($value): Parameter
-    {
-        return new static(strval($value));
-    }
+	/**
+	 * Initialize from a JSON value.
+	 *
+	 * @param string $value
+	 *
+	 * @return static
+	 */
+	public static function fromJSONValue($value): Parameter
+	{
+		return new static(strval($value));
+	}
 }

lib/JWX/Parameter/Parameter.php

Indentation +30 added lines, -30 removed lines

@@ -9,37 +9,37 @@
  */
 abstract class Parameter
 {
-    /**
-     * Parameter name.
-     *
-     * @var string
-     */
-    protected $_name;
+	/**
+	 * Parameter name.
+	 *
+	 * @var string
+	 */
+	protected $_name;
 
-    /**
-     * Parameter value.
-     *
-     * @var mixed
-     */
-    protected $_value;
+	/**
+	 * Parameter value.
+	 *
+	 * @var mixed
+	 */
+	protected $_value;
 
-    /**
-     * Get the parameter name.
-     *
-     * @return string
-     */
-    public function name(): string
-    {
-        return $this->_name;
-    }
+	/**
+	 * Get the parameter name.
+	 *
+	 * @return string
+	 */
+	public function name(): string
+	{
+		return $this->_name;
+	}
 
-    /**
-     * Get the parameter value.
-     *
-     * @return mixed
-     */
-    public function value()
-    {
-        return $this->_value;
-    }
+	/**
+	 * Get the parameter value.
+	 *
+	 * @return mixed
+	 */
+	public function value()
+	{
+		return $this->_value;
+	}
 }

lib/JWX/JWK/Symmetric/SymmetricKeyJWK.php

Indentation +54 added lines, -54 removed lines

@@ -17,61 +17,61 @@
  */
 class SymmetricKeyJWK extends JWK
 {
-    /**
-     * Parameter names managed by this class.
-     *
-     * @internal
-     *
-     * @var string[]
-     */
-    const MANAGED_PARAMS = [
-        JWKParameter::PARAM_KEY_TYPE,
-        JWKParameter::PARAM_KEY_VALUE,
-    ];
+	/**
+	 * Parameter names managed by this class.
+	 *
+	 * @internal
+	 *
+	 * @var string[]
+	 */
+	const MANAGED_PARAMS = [
+		JWKParameter::PARAM_KEY_TYPE,
+		JWKParameter::PARAM_KEY_VALUE,
+	];
 
-    /**
-     * Constructor.
-     *
-     * @param JWKParameter ...$params
-     *
-     * @throws \UnexpectedValueException If missing required parameter
-     */
-    public function __construct(JWKParameter ...$params)
-    {
-        parent::__construct(...$params);
-        foreach (self::MANAGED_PARAMS as $name) {
-            if (!$this->has($name)) {
-                throw new \UnexpectedValueException(
-                    "Missing '{$name}' parameter.");
-            }
-        }
-        if (KeyTypeParameter::TYPE_OCT !== $this->keyTypeParameter()->value()) {
-            throw new \UnexpectedValueException('Invalid key type.');
-        }
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param JWKParameter ...$params
+	 *
+	 * @throws \UnexpectedValueException If missing required parameter
+	 */
+	public function __construct(JWKParameter ...$params)
+	{
+		parent::__construct(...$params);
+		foreach (self::MANAGED_PARAMS as $name) {
+			if (!$this->has($name)) {
+				throw new \UnexpectedValueException(
+					"Missing '{$name}' parameter.");
+			}
+		}
+		if (KeyTypeParameter::TYPE_OCT !== $this->keyTypeParameter()->value()) {
+			throw new \UnexpectedValueException('Invalid key type.');
+		}
+	}
 
-    /**
-     * Initialize from a key string.
-     *
-     * @param string       $key       Symmetric key
-     * @param JWKParameter ...$params Optional additional parameters
-     *
-     * @return self
-     */
-    public static function fromKey(string $key, JWKParameter ...$params): self
-    {
-        $params[] = new KeyTypeParameter(KeyTypeParameter::TYPE_OCT);
-        $params[] = KeyValueParameter::fromString($key);
-        return new self(...$params);
-    }
+	/**
+	 * Initialize from a key string.
+	 *
+	 * @param string       $key       Symmetric key
+	 * @param JWKParameter ...$params Optional additional parameters
+	 *
+	 * @return self
+	 */
+	public static function fromKey(string $key, JWKParameter ...$params): self
+	{
+		$params[] = new KeyTypeParameter(KeyTypeParameter::TYPE_OCT);
+		$params[] = KeyValueParameter::fromString($key);
+		return new self(...$params);
+	}
 
-    /**
-     * Get the symmetric key.
-     *
-     * @return string
-     */
-    public function key(): string
-    {
-        return Base64::urlDecode($this->keyValueParameter()->value());
-    }
+	/**
+	 * Get the symmetric key.
+	 *
+	 * @return string
+	 */
+	public function key(): string
+	{
+		return Base64::urlDecode($this->keyValueParameter()->value());
+	}
 }