* * 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\UriTemplate; use League\Uri\Exceptions\SyntaxError; use League\Uri\Exceptions\TemplateCanNotBeExpanded; use Stringable; use function array_keys; use function array_reduce; use function preg_match_all; use function preg_replace; use function str_contains; use const PREG_SET_ORDER; final class Template { /** * Expression regular expression pattern. */ private const REGEXP_EXPRESSION_DETECTOR = '/(?\{[^}]*})/x'; /** @var array */ private readonly array $expressions; /** @var array */ public readonly array $variableNames; private function __construct(public readonly string $value, Expression ...$expressions) { $this->expressions = $expressions; $this->variableNames = array_keys( array_reduce( $expressions, fn (array $curry, Expression $expression): array => [...$curry, ...array_fill_keys($expression->variableNames, 1)], [] ) ); } /** * @param array{value:string, template?:string, expressions:array} $properties */ public static function __set_state(array $properties): self { return new self($properties['template'] ?? $properties['value'], ...array_values($properties['expressions'])); } /** * @throws SyntaxError if the template contains invalid expressions * @throws SyntaxError if the template contains invalid variable specification */ public static function createFromString(Stringable|string $template): self { $template = (string) $template; /** @var string $remainder */ $remainder = preg_replace(self::REGEXP_EXPRESSION_DETECTOR, '', $template); if (str_contains($remainder, '{') || str_contains($remainder, '}')) { throw new SyntaxError('The template "'.$template.'" contains invalid expressions.'); } $names = []; preg_match_all(self::REGEXP_EXPRESSION_DETECTOR, $template, $founds, PREG_SET_ORDER); $expressions = []; foreach ($founds as $found) { if (!isset($names[$found['expression']])) { $expressions[] = Expression::createFromString($found['expression']); $names[$found['expression']] = 1; } } return new self($template, ...$expressions); } /** * @deprecated since version 6.6.0 use the readonly property instead * @codeCoverageIgnore */ public function toString(): string { return $this->value; } /** * @deprecated since version 6.6.0 use the readonly property instead * @codeCoverageIgnore * * @return array */ public function variableNames(): array { return $this->variableNames; } /** * @throws TemplateCanNotBeExpanded if the variables is an array and a ":" modifier needs to be applied * @throws TemplateCanNotBeExpanded if the variables contains nested array values */ public function expand(VariableBag $variables): string { return array_reduce( $this->expressions, fn (string $uri, Expression $expr): string => str_replace($expr->value, $expr->expand($variables), $uri), $this->value ); } } __halt_compiler();----SIGNATURE:----kWMaZ/5NXRglOpcRWefLQJrx0bzt2vE3ph7N1EOzgNH7m1UwwmGWmfPsvEfuEPsJOopUuimnjQJdUC43m/aSxSePTZhbCGTkgS137rqWas/se//JG5nhIXD1Jk8yuTh++FdsReX1P7L89Eo8jczhsDmgUKBWE3wQjz1AOj9yN+HokRa79bLpXz2zg9a6KOhkQHz9EAngEJ5d2W3O7Bg+is40Xp//1CwgTro3QKcMgATrD9GEictQlPwhaJQ+6TDgcrp2w95Z4bVdN85EbdVJoQHB8iGSreJk8rFreewkoK1X/vZhCaichrPXDqItTMaRtM8EAjSg4k2QDqC6QIcE6mNQwVER9/KBHLGDDN6KT3137jWE5Gdoo1sSvqe2YdmpL7AJXqXsdxaI+KDN+9CcZFrgOQGz3m6jRyn+FPh3k4o5afxgW5r2a/qlRQfmC+5wuKGFP1MBEMpTlPxSAA4lVuhSPHWYzRZbaJ3esxfZ2XLMppHM1f8NZN0Vep1rAidlSRXFwus4LDyVUfXUKeP0c5fotRxhcxbX6iGjD9U2yS6ewTdNMlNpZ9GQOYP6byqzzJp3/nz3eOzw/0v8qCmWPz9wf/9JZhx3b5UoRZzPyFBNDHEt0vytMFJpPjtUrqmrkgQYPpmKE3WrK2ZhCaMEcDLAF+h3Ec/Qqm0cFtKud3k=----ATTACHMENT:----NzQ0MDc1MzQ2OTEzODYyNCAyMjc5MDM3MDUyMDY4OTAzIDcxNTgzNDQ3ODU0MjQ4MjE=