Exceptions
3 years ago
UriTemplate
3 years ago
Http.php
3 years ago
HttpFactory.php
3 years ago
Uri.php
3 years ago
UriInfo.php
3 years ago
UriResolver.php
3 years ago
UriString.php
3 years ago
UriTemplate.php
3 years ago
UriTemplate.php
124 lines
| 1 | <?php |
| 2 | |
| 3 | /** |
| 4 | * League.Uri (https://uri.thephpleague.com) |
| 5 | * |
| 6 | * (c) Ignace Nyamagana Butera <nyamsprod@gmail.com> |
| 7 | * |
| 8 | * For the full copyright and license information, please view the LICENSE |
| 9 | * file that was distributed with this source code. |
| 10 | */ |
| 11 | declare (strict_types=1); |
| 12 | namespace IAWP\League\Uri; |
| 13 | |
| 14 | use IAWP\League\Uri\Contracts\UriException; |
| 15 | use IAWP\League\Uri\Contracts\UriInterface; |
| 16 | use IAWP\League\Uri\Exceptions\SyntaxError; |
| 17 | use IAWP\League\Uri\Exceptions\TemplateCanNotBeExpanded; |
| 18 | use IAWP\League\Uri\UriTemplate\Template; |
| 19 | use IAWP\League\Uri\UriTemplate\VariableBag; |
| 20 | /** |
| 21 | * Defines the URI Template syntax and the process for expanding a URI Template into a URI reference. |
| 22 | * |
| 23 | * @link https://tools.ietf.org/html/rfc6570 |
| 24 | * @package League\Uri |
| 25 | * @author Ignace Nyamagana Butera <nyamsprod@gmail.com> |
| 26 | * @since 6.1.0 |
| 27 | * |
| 28 | * Based on GuzzleHttp\UriTemplate class in Guzzle v6.5. |
| 29 | * @link https://github.com/guzzle/guzzle/blob/6.5/src/UriTemplate.php |
| 30 | */ |
| 31 | final class UriTemplate |
| 32 | { |
| 33 | /** |
| 34 | * @var Template |
| 35 | */ |
| 36 | private $template; |
| 37 | /** |
| 38 | * @var VariableBag |
| 39 | */ |
| 40 | private $defaultVariables; |
| 41 | /** |
| 42 | * @param object|string $template a string or an object with the __toString method |
| 43 | * |
| 44 | * @throws \TypeError if the template is not a string or an object with the __toString method |
| 45 | * @throws SyntaxError if the template syntax is invalid |
| 46 | * @throws TemplateCanNotBeExpanded if the template variables are invalid |
| 47 | */ |
| 48 | public function __construct($template, array $defaultVariables = []) |
| 49 | { |
| 50 | $this->template = Template::createFromString($template); |
| 51 | $this->defaultVariables = $this->filterVariables($defaultVariables); |
| 52 | } |
| 53 | public static function __set_state(array $properties) : self |
| 54 | { |
| 55 | return new self($properties['template']->toString(), $properties['defaultVariables']->all()); |
| 56 | } |
| 57 | /** |
| 58 | * Filters out variables for the given template. |
| 59 | * |
| 60 | * @param array<string,string|array<string>> $variables |
| 61 | */ |
| 62 | private function filterVariables(array $variables) : VariableBag |
| 63 | { |
| 64 | $output = new VariableBag(); |
| 65 | foreach ($this->template->variableNames() as $name) { |
| 66 | if (isset($variables[$name])) { |
| 67 | $output->assign($name, $variables[$name]); |
| 68 | } |
| 69 | } |
| 70 | return $output; |
| 71 | } |
| 72 | /** |
| 73 | * The template string. |
| 74 | */ |
| 75 | public function getTemplate() : string |
| 76 | { |
| 77 | return $this->template->toString(); |
| 78 | } |
| 79 | /** |
| 80 | * Returns the names of the variables in the template, in order. |
| 81 | * |
| 82 | * @return string[] |
| 83 | */ |
| 84 | public function getVariableNames() : array |
| 85 | { |
| 86 | return $this->template->variableNames(); |
| 87 | } |
| 88 | /** |
| 89 | * Returns the default values used to expand the template. |
| 90 | * |
| 91 | * The returned list only contains variables whose name is part of the current template. |
| 92 | * |
| 93 | * @return array<string,string|array> |
| 94 | */ |
| 95 | public function getDefaultVariables() : array |
| 96 | { |
| 97 | return $this->defaultVariables->all(); |
| 98 | } |
| 99 | /** |
| 100 | * Returns a new instance with the updated default variables. |
| 101 | * |
| 102 | * This method MUST retain the state of the current instance, and return |
| 103 | * an instance that contains the modified default variables. |
| 104 | * |
| 105 | * If present, variables whose name is not part of the current template |
| 106 | * possible variable names are removed. |
| 107 | */ |
| 108 | public function withDefaultVariables(array $defaultDefaultVariables) : self |
| 109 | { |
| 110 | $clone = clone $this; |
| 111 | $clone->defaultVariables = $this->filterVariables($defaultDefaultVariables); |
| 112 | return $clone; |
| 113 | } |
| 114 | /** |
| 115 | * @throws TemplateCanNotBeExpanded if the variable contains nested array values |
| 116 | * @throws UriException if the resulting expansion can not be converted to a UriInterface instance |
| 117 | */ |
| 118 | public function expand(array $variables = []) : UriInterface |
| 119 | { |
| 120 | $uriString = $this->template->expand($this->filterVariables($variables)->replace($this->defaultVariables)); |
| 121 | return Uri::createFromString($uriString); |
| 122 | } |
| 123 | } |
| 124 |