* * 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\FragmentDirectives; use BackedEnum; use League\Uri\Contracts\FragmentDirective; use League\Uri\Encoder; use League\Uri\Exceptions\SyntaxError; use League\Uri\StringCoercionMode; use Stringable; use Throwable; use function explode; use function str_replace; final class GenericDirective implements FragmentDirective { /** * @param non-empty-string $name */ private function __construct( private readonly string $name, private readonly ?string $value = null, ) { } /** * Create a new instance from a string without the Directive delimiter (:~:) or a separator (&). */ public static function fromString(BackedEnum|Stringable|string $value): self { if ($value instanceof BackedEnum) { $value = (string) $value->value; } [$name, $value] = explode('=', (string) $value, 2) + [1 => null]; (null !== $name && '' !== $name && !str_contains($name, '&')) || throw new SyntaxError('The submitted text is not a valid directive.'); return new self($name, $value); } private static function decode(?string $value): ?string { return null !== $value ? str_replace('%20', ' ', (string) Encoder::decodeFragment($value)) : null; } public function name(): string { /** @var non-empty-string $name */ $name = (string) self::decode($this->name); return $name; } public function value(): ?string { return self::decode($this->value); } public function toString(): string { $str = $this->name; if (null === $this->value) { return $str; } return $str.'='.$this->value; } public function __toString(): string { return $this->toString(); } public function toFragmentValue(): string { return ':~:'.$this->toString(); } public function equals(mixed $directive): bool { if (null === $directive || ! StringCoercionMode::Native->isCoercible($directive)) { return false; } if (!$directive instanceof FragmentDirective) { try { $directive = self::fromString((string) StringCoercionMode::Native->coerce($directive)); } catch (Throwable) { return false; } } return $directive->toString() === $this->toString(); } }