* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Components; use BackedEnum; use League\Uri\Contracts\Conditionable; use League\Uri\Contracts\Transformable; use League\Uri\Contracts\UriComponentInterface; use League\Uri\Contracts\UriInterface; use League\Uri\Encoder; use League\Uri\Exceptions\SyntaxError; use League\Uri\Modifier; use League\Uri\StringCoercionMode; use League\Uri\Uri; use Psr\Http\Message\UriInterface as Psr7UriInterface; use Stringable; use Uri\Rfc3986\Uri as Rfc3986Uri; use Uri\WhatWg\Url as WhatWgUrl; use function is_bool; use function preg_match; use function sprintf; abstract class Component implements UriComponentInterface, Conditionable, Transformable { protected const REGEXP_INVALID_URI_CHARS = '/[\x00-\x1f\x7f]/'; abstract public function value(): ?string; public function jsonSerialize(): ?string { return $this->value(); } public function toString(): string { return $this->value() ?? ''; } public function __toString(): string { return $this->toString(); } public function getUriComponent(): string { return $this->toString(); } final protected static function filterUri(WhatWgUrl|Rfc3986Uri|BackedEnum|Stringable|string $uri): WhatWgUrl|Rfc3986Uri|UriInterface|Psr7UriInterface { if ($uri instanceof Modifier) { return $uri->unwrap(); } if ($uri instanceof Rfc3986Uri || $uri instanceof WhatWgUrl || $uri instanceof PSR7UriInterface || $uri instanceof UriInterface ) { return $uri; } return Uri::new($uri); } /** * Validate the component content. */ protected function validateComponent(BackedEnum|Stringable|int|string|null $component): ?string { return Encoder::decodeNecessary($component); } /** * Filter the input component. * * @throws SyntaxError If the component cannot be converted to a string or null */ final protected static function filterComponent(BackedEnum|Stringable|int|string|null $component): ?string { $component = StringCoercionMode::Native->coerce($component); return match (true) { null === $component => null, 1 === preg_match(self::REGEXP_INVALID_URI_CHARS, $component) => throw new SyntaxError(sprintf('Invalid component string: %s.', $component)), default => $component, }; } final public function when(callable|bool $condition, callable $onSuccess, ?callable $onFail = null): static { if (!is_bool($condition)) { $condition = $condition($this); } return match (true) { $condition => $onSuccess($this), null !== $onFail => $onFail($this), default => $this, } ?? $this; } final public function transform(callable $callback): static { return $callback($this); } }