63 lines
1.7 KiB
PHP
63 lines
1.7 KiB
PHP
<?php
|
|
|
|
namespace Kirby\Query;
|
|
|
|
use Kirby\Toolkit\A;
|
|
use Kirby\Toolkit\Collection;
|
|
|
|
/**
|
|
* The Arguments class helps splitting a
|
|
* parameter string into processable arguments
|
|
*
|
|
* @package Kirby Query
|
|
* @author Nico Hoffmann <nico@getkirby.com>
|
|
* @link https://getkirby.com
|
|
* @copyright Bastian Allgeier
|
|
* @license https://opensource.org/licenses/MIT
|
|
*
|
|
* @todo Deprecate in v6
|
|
*
|
|
* @extends \Kirby\Toolkit\Collection<\Kirby\Query\Argument>
|
|
*/
|
|
class Arguments extends Collection
|
|
{
|
|
// skip all matches inside of parantheses
|
|
public const NO_PNTH = '\([^)]+\)(*SKIP)(*FAIL)';
|
|
// skip all matches inside of square brackets
|
|
public const NO_SQBR = '\[[^]]+\](*SKIP)(*FAIL)';
|
|
// skip all matches inside of double quotes
|
|
public const NO_DLQU = '\"(?:[^"\\\\]|\\\\.)*\"(*SKIP)(*FAIL)';
|
|
// skip all matches inside of single quotes
|
|
public const NO_SLQU = '\'(?:[^\'\\\\]|\\\\.)*\'(*SKIP)(*FAIL)';
|
|
// skip all matches inside of any of the above skip groups
|
|
public const OUTSIDE =
|
|
self::NO_PNTH . '|' . self::NO_SQBR . '|' .
|
|
self::NO_DLQU . '|' . self::NO_SLQU;
|
|
|
|
/**
|
|
* Splits list of arguments into individual
|
|
* Argument instances while respecting skip groups
|
|
*/
|
|
public static function factory(string $arguments): static
|
|
{
|
|
$arguments = A::map(
|
|
// split by comma, but not inside skip groups
|
|
preg_split('!,|' . self::OUTSIDE . '!', $arguments),
|
|
fn ($argument) => Argument::factory($argument)
|
|
);
|
|
|
|
return new static($arguments);
|
|
}
|
|
|
|
/**
|
|
* Resolve each argument, so that they can
|
|
* passed together to the actual method call
|
|
*/
|
|
public function resolve(array|object $data = []): array
|
|
{
|
|
return A::map(
|
|
$this->data,
|
|
fn ($argument) => $argument->resolve($data)
|
|
);
|
|
}
|
|
}
|