121 lines
2.9 KiB
PHP
121 lines
2.9 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Jose\Component\Signature;
|
|
|
|
use function array_key_exists;
|
|
use InvalidArgumentException;
|
|
|
|
class Signature
|
|
{
|
|
private readonly ?string $encodedProtectedHeader;
|
|
|
|
/**
|
|
* @var array<string, mixed>
|
|
*/
|
|
private readonly array $protectedHeader;
|
|
|
|
/**
|
|
* @param array{alg?: string, string?: mixed} $protectedHeader
|
|
* @param array{alg?: string, string?: mixed} $header
|
|
*/
|
|
public function __construct(
|
|
private readonly string $signature,
|
|
array $protectedHeader,
|
|
?string $encodedProtectedHeader,
|
|
private readonly array $header
|
|
) {
|
|
$this->protectedHeader = $encodedProtectedHeader === null ? [] : $protectedHeader;
|
|
$this->encodedProtectedHeader = $encodedProtectedHeader;
|
|
}
|
|
|
|
/**
|
|
* The protected header associated with the signature.
|
|
*
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function getProtectedHeader(): array
|
|
{
|
|
return $this->protectedHeader;
|
|
}
|
|
|
|
/**
|
|
* The unprotected header associated with the signature.
|
|
*
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function getHeader(): array
|
|
{
|
|
return $this->header;
|
|
}
|
|
|
|
/**
|
|
* The protected header associated with the signature.
|
|
*/
|
|
public function getEncodedProtectedHeader(): ?string
|
|
{
|
|
return $this->encodedProtectedHeader;
|
|
}
|
|
|
|
/**
|
|
* Returns the value of the protected header of the specified key.
|
|
*
|
|
* @param string $key The key
|
|
*
|
|
* @return mixed|null Header value
|
|
*/
|
|
public function getProtectedHeaderParameter(string $key)
|
|
{
|
|
if ($this->hasProtectedHeaderParameter($key)) {
|
|
return $this->getProtectedHeader()[$key];
|
|
}
|
|
|
|
throw new InvalidArgumentException(sprintf('The protected header "%s" does not exist', $key));
|
|
}
|
|
|
|
/**
|
|
* Returns true if the protected header has the given parameter.
|
|
*
|
|
* @param string $key The key
|
|
*/
|
|
public function hasProtectedHeaderParameter(string $key): bool
|
|
{
|
|
return array_key_exists($key, $this->getProtectedHeader());
|
|
}
|
|
|
|
/**
|
|
* Returns the value of the unprotected header of the specified key.
|
|
*
|
|
* @param string $key The key
|
|
*
|
|
* @return mixed|null Header value
|
|
*/
|
|
public function getHeaderParameter(string $key)
|
|
{
|
|
if (array_key_exists($key, $this->header)) {
|
|
return $this->header[$key];
|
|
}
|
|
|
|
throw new InvalidArgumentException(sprintf('The header "%s" does not exist', $key));
|
|
}
|
|
|
|
/**
|
|
* Returns true if the unprotected header has the given parameter.
|
|
*
|
|
* @param string $key The key
|
|
*/
|
|
public function hasHeaderParameter(string $key): bool
|
|
{
|
|
return array_key_exists($key, $this->header);
|
|
}
|
|
|
|
/**
|
|
* Returns the value of the signature.
|
|
*/
|
|
public function getSignature(): string
|
|
{
|
|
return $this->signature;
|
|
}
|
|
}
|