131 lines
3.8 KiB
PHP
131 lines
3.8 KiB
PHP
<?php
|
|
|
|
/**
|
|
* League.Uri (https://uri.thephpleague.com)
|
|
*
|
|
* (c) Ignace Nyamagana Butera <nyamsprod@gmail.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
declare (strict_types=1);
|
|
namespace WP_Ultimo\Dependencies\League\Uri\UriTemplate;
|
|
|
|
use ArrayAccess;
|
|
use Closure;
|
|
use Countable;
|
|
use IteratorAggregate;
|
|
use Stringable;
|
|
use Traversable;
|
|
use function array_filter;
|
|
use function is_bool;
|
|
use function is_scalar;
|
|
use const ARRAY_FILTER_USE_BOTH;
|
|
/**
|
|
* @internal The class exposes the internal representation of variable bags
|
|
*
|
|
* @phpstan-type InputValue string|bool|int|float|array<string|bool|int|float>
|
|
*
|
|
* @implements ArrayAccess<string, InputValue>
|
|
* @implements IteratorAggregate<string, InputValue>
|
|
*/
|
|
final class VariableBag implements ArrayAccess, Countable, IteratorAggregate
|
|
{
|
|
/**
|
|
* @var array<string,string|array<string>>
|
|
*/
|
|
private array $variables = [];
|
|
/**
|
|
* @param iterable<array-key, InputValue> $variables
|
|
*/
|
|
public function __construct(iterable $variables = [])
|
|
{
|
|
foreach ($variables as $name => $value) {
|
|
$this->assign((string) $name, $value);
|
|
}
|
|
}
|
|
public function count() : int
|
|
{
|
|
return \count($this->variables);
|
|
}
|
|
public function getIterator() : Traversable
|
|
{
|
|
yield from $this->variables;
|
|
}
|
|
public function offsetExists(mixed $offset) : bool
|
|
{
|
|
return \array_key_exists($offset, $this->variables);
|
|
}
|
|
public function offsetUnset(mixed $offset) : void
|
|
{
|
|
unset($this->variables[$offset]);
|
|
}
|
|
public function offsetSet(mixed $offset, mixed $value) : void
|
|
{
|
|
$this->assign($offset, $value);
|
|
/* @phpstan-ignore-line */
|
|
}
|
|
public function offsetGet(mixed $offset) : mixed
|
|
{
|
|
return $this->fetch($offset);
|
|
}
|
|
/**
|
|
* Tells whether the bag is empty or not.
|
|
*/
|
|
public function isEmpty() : bool
|
|
{
|
|
return [] === $this->variables;
|
|
}
|
|
/**
|
|
* Tells whether the bag is empty or not.
|
|
*/
|
|
public function isNotEmpty() : bool
|
|
{
|
|
return [] !== $this->variables;
|
|
}
|
|
/**
|
|
* Fetches the variable value if none found returns null.
|
|
*
|
|
* @return null|string|array<string>
|
|
*/
|
|
public function fetch(string $name) : null|string|array
|
|
{
|
|
return $this->variables[$name] ?? null;
|
|
}
|
|
/**
|
|
* @param Stringable|InputValue $value
|
|
*/
|
|
public function assign(string $name, Stringable|string|bool|int|float|array|null $value) : void
|
|
{
|
|
$this->variables[$name] = $this->normalizeValue($value, $name, \true);
|
|
}
|
|
/**
|
|
* @param Stringable|InputValue $value
|
|
*
|
|
* @throws TemplateCanNotBeExpanded if the value contains nested list
|
|
*/
|
|
private function normalizeValue(Stringable|string|float|int|bool|array|null $value, string $name, bool $isNestedListAllowed) : array|string
|
|
{
|
|
return match (\true) {
|
|
is_bool($value) => \true === $value ? '1' : '0',
|
|
null === $value || is_scalar($value) || $value instanceof Stringable => (string) $value,
|
|
!$isNestedListAllowed => throw TemplateCanNotBeExpanded::dueToNestedListOfValue($name),
|
|
default => \array_map(fn($var): array|string => self::normalizeValue($var, $name, \false), $value),
|
|
};
|
|
}
|
|
/**
|
|
* Replaces elements from passed variables into the current instance.
|
|
*/
|
|
public function replace(VariableBag $variables) : self
|
|
{
|
|
return new self($this->variables + $variables->variables);
|
|
}
|
|
/**
|
|
* Filters elements using the closure.
|
|
*/
|
|
public function filter(Closure $fn) : self
|
|
{
|
|
return new self(array_filter($this->variables, $fn, ARRAY_FILTER_USE_BOTH));
|
|
}
|
|
}
|