allow vendord

vendor/rize/uri-template/src/Rize/UriTemplate.php

@@ -0,0 +1,98 @@
+<?php
+
+namespace Rize;
+
+use Rize\UriTemplate\Parser;
+
+/**
+ * URI Template.
+ */
+class UriTemplate
+{
+    protected Parser $parser;
+    protected array $parsed = [];
+
+    public function __construct(protected string $base_uri = '', protected array $params = [], ?Parser $parser = null)
+    {
+        $this->parser = $parser ?: $this->createNodeParser();
+    }
+
+    /**
+     * Expands URI Template.
+     *
+     * @param mixed $params
+     */
+    public function expand(string $uri, $params = []): string
+    {
+        $params += $this->params;
+        $uri     = $this->base_uri . $uri;
+        $result  = [];
+
+        // quick check
+        if (!str_contains($uri, '{')) {
+            return $uri;
+        }
+
+        $parser = $this->parser;
+        $nodes  = $parser->parse($uri);
+
+        foreach ($nodes as $node) {
+            $result[] = $node->expand($parser, $params);
+        }
+
+        return implode('', $result);
+    }
+
+    /**
+     * Extracts variables from URI.
+     *
+     * @return null|array params or null if not match and $strict is true
+     */
+    public function extract(string $template, string $uri, bool $strict = false): ?array
+    {
+        $params = [];
+        $nodes  = $this->parser->parse($template);
+
+        // PHP 8.1.0RC4-dev still throws deprecation warning for `strlen`.
+        // $uri    = (string) $uri;
+
+        foreach ($nodes as $node) {
+            // if strict is given, and there's no remaining uri just return null
+            if ($strict && (string) $uri === '') {
+                return null;
+            }
+
+            // URI will be truncated from the start when a match is found
+            $match = $node->match($this->parser, $uri, $params, $strict);
+
+            if ($match === null) {
+                return null;
+            }
+
+            [$uri, $params] = $match;
+        }
+
+        // if there's remaining $uri, matching is failed
+        if ($strict && (string) $uri !== '') {
+            return null;
+        }
+
+        return $params;
+    }
+
+    public function getParser(): Parser
+    {
+        return $this->parser;
+    }
+
+    protected function createNodeParser(): Parser
+    {
+        static $parser;
+
+        if ($parser) {
+            return $parser;
+        }
+
+        return $parser = new Parser();
+    }
+}