| Current Path : /srv/web/sites/trentinoplant.it/httpdocs/vendor1/laminas/laminas-router/src/Http/ |
| Current File : /srv/web/sites/trentinoplant.it/httpdocs/vendor1/laminas/laminas-router/src/Http/Method.php |
<?php
declare(strict_types=1);
namespace Laminas\Router\Http;
use Laminas\Router\Exception;
use Laminas\Stdlib\ArrayUtils;
use Laminas\Stdlib\RequestInterface as Request;
use Traversable;
use function array_map;
use function explode;
use function in_array;
use function is_array;
use function method_exists;
use function sprintf;
use function strtoupper;
/**
* Method route.
*/
class Method implements RouteInterface
{
/**
* Verb to match.
*
* @var string
*/
protected $verb;
/**
* Default values.
*
* @var array
*/
protected $defaults;
/**
* @internal
* @deprecated Since 3.9.0 This property will be removed or made private in version 4.0
*
* @var int|null
*/
public $priority;
/**
* Create a new method route.
*
* @param string $verb
* @param array $defaults
*/
public function __construct($verb, array $defaults = [])
{
$this->verb = $verb;
$this->defaults = $defaults;
}
/**
* factory(): defined by RouteInterface interface.
*
* @see \Laminas\Router\RouteInterface::factory()
*
* @param iterable $options
* @return Method
* @throws Exception\InvalidArgumentException
*/
public static function factory($options = [])
{
if ($options instanceof Traversable) {
$options = ArrayUtils::iteratorToArray($options);
} elseif (! is_array($options)) {
throw new Exception\InvalidArgumentException(sprintf(
'%s expects an array or Traversable set of options',
__METHOD__
));
}
if (! isset($options['verb'])) {
throw new Exception\InvalidArgumentException('Missing "verb" in options array');
}
if (! isset($options['defaults'])) {
$options['defaults'] = [];
}
return new static($options['verb'], $options['defaults']);
}
/**
* match(): defined by RouteInterface interface.
*
* @see \Laminas\Router\RouteInterface::match()
*
* @return RouteMatch|null
*/
public function match(Request $request)
{
if (! method_exists($request, 'getMethod')) {
return null;
}
$requestVerb = strtoupper($request->getMethod());
$matchVerbs = explode(',', strtoupper($this->verb));
$matchVerbs = array_map('trim', $matchVerbs);
if (in_array($requestVerb, $matchVerbs)) {
return new RouteMatch($this->defaults);
}
return null;
}
/**
* assemble(): Defined by RouteInterface interface.
*
* @see \Laminas\Router\RouteInterface::assemble()
*
* @param array $params
* @param array $options
* @return mixed
*/
public function assemble(array $params = [], array $options = [])
{
// The request method does not contribute to the path, thus nothing is returned.
return '';
}
/**
* getAssembledParams(): defined by RouteInterface interface.
*
* @see RouteInterface::getAssembledParams
*
* @return array
*/
public function getAssembledParams()
{
return [];
}
}