[\.\/;\?&\=,\!@\|\+#])?(?[^\}]*))\}$/'; /** * Reserved Operator characters. * * @link https://tools.ietf.org/html/rfc6570#section-2.2 */ private const RESERVED_OPERATOR = '=,!@|'; case None = ''; case ReservedChars = '+'; case Label = '.'; case Path = '/'; case PathParam = ';'; case Query = '?'; case QueryPair = '&'; case Fragment = '#'; public function first(): string { return match ($this) { self::None, self::ReservedChars => '', default => $this->value, }; } public function separator(): string { return match ($this) { self::None, self::ReservedChars, self::Fragment => ',', self::Query, self::QueryPair => '&', default => $this->value, }; } public function isNamed(): bool { return match ($this) { self::Query, self::PathParam, self::QueryPair => true, default => false, }; } /** * Removes percent encoding on reserved characters (used with + and # modifiers). */ public function decode(string $var): string { static $delimiters = [ ':', '/', '?', '#', '[', ']', '@', '!', '$', '&', '\'', '(', ')', '*', '+', ',', ';', '=', ]; static $delimitersEncoded = [ '%3A', '%2F', '%3F', '%23', '%5B', '%5D', '%40', '%21', '%24', '%26', '%27', '%28', '%29', '%2A', '%2B', '%2C', '%3B', '%3D', ]; return match ($this) { Operator::ReservedChars, Operator::Fragment => str_replace($delimitersEncoded, $delimiters, rawurlencode($var)), default => rawurlencode($var), }; } /** * @throws SyntaxError if the expression is invalid * @throws SyntaxError if the operator used in the expression is invalid * @throws SyntaxError if the contained variable specifiers are invalid * * @return array{operator:Operator, variables:string} */ public static function parseExpression(string $expression): array { if (1 !== preg_match(self::REGEXP_EXPRESSION, $expression, $parts)) { throw new SyntaxError('The expression "'.$expression.'" is invalid.'); } /** @var array{operator:string, variables:string} $parts */ $parts = $parts + ['operator' => '']; if ('' !== $parts['operator'] && str_contains(self::RESERVED_OPERATOR, $parts['operator'])) { throw new SyntaxError('The operator used in the expression "'.$expression.'" is reserved.'); } return [ 'operator' => self::from($parts['operator']), 'variables' => $parts['variables'], ]; } /** * Replaces an expression with the given variables. * * @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(VarSpecifier $varSpecifier, VariableBag $variables): string { $value = $variables->fetch($varSpecifier->name); if (null === $value) { return ''; } [$expanded, $actualQuery] = $this->inject($value, $varSpecifier); if (!$actualQuery) { return $expanded; } if ('&' !== $this->separator() && '' === $expanded) { return $varSpecifier->name; } return $varSpecifier->name.'='.$expanded; } /** * @param string|array $value * * @return array{0:string, 1:bool} */ private function inject(array|string $value, VarSpecifier $varSpec): array { if (is_array($value)) { return $this->replaceList($value, $varSpec); } if (':' === $varSpec->modifier) { $value = substr($value, 0, $varSpec->position); } return [$this->decode($value), $this->isNamed()]; } /** * Expands an expression using a list of values. * * @param array $value * * @throws TemplateCanNotBeExpanded if the variables is an array and a ":" modifier needs to be applied * * @return array{0:string, 1:bool} */ private function replaceList(array $value, VarSpecifier $varSpec): array { if (':' === $varSpec->modifier) { throw TemplateCanNotBeExpanded::dueToUnableToProcessValueListWithPrefix($varSpec->name); } if ([] === $value) { return ['', false]; } $pairs = []; $isList = array_is_list($value); $useQuery = $this->isNamed(); foreach ($value as $key => $var) { if (!$isList) { $key = rawurlencode((string) $key); } $var = $this->decode($var); if ('*' === $varSpec->modifier) { if (!$isList) { $var = $key.'='.$var; } elseif ($key > 0 && $useQuery) { $var = $varSpec->name.'='.$var; } } $pairs[$key] = $var; } if ('*' === $varSpec->modifier) { if (!$isList) { // Don't prepend the value name when using the `explode` modifier with an associative array. $useQuery = false; } return [implode($this->separator(), $pairs), $useQuery]; } if (!$isList) { // When an associative array is encountered and the `explode` modifier is not set, then // the result must be a comma separated list of keys followed by their respective values. $retVal = []; foreach ($pairs as $offset => $data) { $retVal[$offset] = $offset.','.$data; } $pairs = $retVal; } return [implode(',', $pairs), $useQuery]; } } __halt_compiler();----SIGNATURE:----mFDhTjfVyP+CH4RGqA1Xtb3gE3VbDXNr0051KZMCpM0p1q8d5FpYnrGj8/CcQesiBnnH4sIkOrM6IswvA72tXY6fmhD9GnLzSBugPNjvfTyqM/wEc+KTxL2p92yn3tN5x7RnsBRhb9zk6/BtqMcjtUEvPbaqhvns8cm1J/cwUPlD7Y+gJpC+5bUE9cJHGxzOptE3O1nCDgBANMGaUxgweTzxAOY8bjzXJU+ltOzsZiZk4axTSaJu2wSJ3iaBiquCfZMHENGkI094cGhDWCRTcTroK/aSWMhvTBMU64jAUoNhdOUFvU65ho86EpZ+KpfM5fesgvWA86GfUjQ9MlFbYVSSCE3JHqRSBredNXXR9q4fZXVaXbJ6wZNyzcCTFSjLEZVCB3dRkMwyepDLfkP9LwEdaRd+4cdw33iP45QA1CpBU1l/ff39ueMtnw6E6BKUOGlT513aWZUoJQT9CvsyzXE9L+RJPU+qBjnF5ltCuxbZctq4c6zvfiiANdldbRb7LF9eXhv33YoedbcAXRQ8APW4CbOj1WyJhjqN8V30vil2Ls77pEniHWuZ0Df0L6zwCbwlwU9bEc6e9MKnE1z2CKOL1L8kfRvm0c23HCGGqP2vqTnA7xS0+ampYcTv763Cgb1EGX+BccKVCiSxJDCrAispukWynIZmCisG6EUUHfc=----ATTACHMENT:----MzgxMDY4MDYzNzU5NDgyNSAyNTcxMjIyMDE3NDM1NDggNjk2OTIwMDg1OTkxNTg4NQ==