Route::name() - Code Metrics - lenevor/syscodes - Measure and Improve Code Quality continuously with Scrutinizer

Route::name() A
last analyzed 2021-03-26 23:28 UTC

↳ Parent: Route
Complexity

Conditions	2
Paths	2
Size

Total Lines	5
Code Lines	2
Duplication

Lines	0
Ratio	0 %
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	2
eloc	2
c	1
b	0
f	0
nc	2
nop	1
dl	0
loc	5
rs	10
<?php 

/**
 * Lenevor Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file license.md.
 * It is also available through the world-wide-web at this URL:
 * https://lenevor.com/license
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to [email protected] so we can send you a copy immediately.
 *
 * @package     Lenevor
 * @subpackage  Base
 * @link        https://lenevor.com
 * @copyright   Copyright (c) 2019 - 2021 Alexander Campo <[email protected]>
 * @license     https://opensource.org/licenses/BSD-3-Clause New BSD license or see https://lenevor.com/license or see /license.md
 */

namespace Syscodes\Routing;

use Closure;
use LogicException;
use ReflectionFunction;
use Syscodes\Support\Str;
use Syscodes\Http\Request;
use InvalidArgumentException;
use Syscodes\Collections\Arr;
use Syscodes\Container\Container;
use Syscodes\Controller\ControllerDispatcher;
use Syscodes\Http\Exceptions\HttpResponseException;

/**
 * A Route describes a route and its parameters.
 * 
 * @author Alexander Campo <[email protected]>
 */
class Route 
{
	use Concerns\RouteCondition,

	    Concerns\RouteDependencyResolver;
	
	/**
	 * Action that the route will use when called.
	 *
	 * @var \Closure|string|array $action
	 */
	public $action;

	/**
	 * The computed gathered middleware.
	 * 
	 * @var array|null $computedMiddleware
	 */
	public $computedMiddleware;

	/**
	 * The container instance used by the route.
	 * 
	 * @var \Syscodes\Container\Container $container
	 */
	protected $container;

	/**
	 * The controller instance.
	 * 
	 * @var string $controller
	 */
	public $controller;

	/**
	 * The default values for the route.
	 * 
	 * @var array $defaults
	 */
	public $defaults = [];

	/**
	 * Variable of HTTP method.
	 *  
	 * @var array|string $method
	 */
	public $method;

	/**
	 * The array of matched parameters.
	 * 
	 * @var array $parameters
	 */
	public $parameters = [];

	/**
	 * The parameter names for the route.
	 * 
	 * @var string|null $parameterNames
	 */
	public $parameterNames;

	/**
	* Patterns that should be replaced.
	*
	* @var array $patterns 
	*/
	public $patterns = [
		'~/~'                    =>  '\/',               // Slash
		'~{an:[^\/{}]+}~'        => '([0-9a-zA-Z]++)',   // Placeholder accepts alphabetic and numeric chars
		'~{n:[^\/{}]+}~'         => '([0-9]++)',         // Placeholder accepts only numeric
		'~{a:[^\/{}]+}~'         => '([a-zA-Z]++)',      // Placeholder accepts only alphabetic chars
		'~{w:[^\/{}]+}~'         => '([0-9a-zA-Z-_]++)', // Placeholder accepts alphanumeric and underscore
		'~{\*:[^\/{}]+}~'        => '(.++)',             // Placeholder match rest of url
		'~(\\\/)?{\?:[^\/{}]+}~' => '\/?([^\/]*)',		 // Optional placeholder
		'~{[^\/{}]+}~'           => '([^\/]++)'			 // Normal placeholder
	];

	/**
	 * The URI pattern the route responds to.
	 *
	 * @var array $uri
	 */
	public $uri = [];

	/**
	 * Contains the arguments of the current route.
	 *
	 * @var array $where
	 */
	public $wheres = [];

	/**
	 * Constructor. Initialize route.
	 *
	 * @param  array|string|null  $method  
	 * @param  string|null  $uri  
	 * @param  \Closure|string|null  $action  
	 *
	 * @return void
	 */
	public function __construct($method = null, $uri = null, $action = null)
	{
		$this->uri = $uri;
class Id
{
    public $id;

    public function __construct($id)
    {
        $this->id = $id;
    }

}

class Account
{
    /** @var  Id $id */
    public $id;
}

$account_id = false;

if (starsAreRight()) {
    $account_id = new Id(42);
}

$account = new Account();
if ($account instanceof Id)
{
    $account->id = $account_id;
}

		// Set the method
		$this->method = $this->parseMethod($method);
		$this->method = $this->parseMethod(/** @scrutinizer ignore-type */ $method);

		// Set the action
		$this->action = Arr::except($this->parseAction($action), ['prefix']);
		$this->action = Arr::except(/** @scrutinizer ignore-type */ $this->parseAction($action), ['prefix']);

		if (is_null($prefix = Arr::get($this->action, 'prefix'))) {
			$this->prefix($prefix);
		}
	}

	// Getters

	/**
	 * Get the action of the current route.
	 *
	 * @return \Closure|string|array
	 */
	public function getAction()
	{
		return $this->action;
	}

	/**
	 * Get the arguments of the current route.
	 *
	 * @return array
	 */
	public function getArguments()
	{
		return $this->wheres;
	}

	/**
	 * Get the controller instance for the route.
	 * 
	 * @return mixed
	 */
	public function getController()
	{
		if ( ! $this->controller) {
			$class = $this->parseControllerCallback()[0];
 
			$this->controller = $this->container->make(ltrim($class, '\\'));

		}

		return $this->controller;
	}

	/**
	 * Get the controller method used for the route.
	 * 
	 * @return string
	 */
	public function getControllerMethod()
	{
		return $this->parseControllerCallback()[1];
	}

	/**
	 * Get the request method of the current route.
	 *
	 * @return array|string
	 */
	public function getMethod()
	{
		return $this->method;
	}

	/**
	 * Get the url of the current route.
	 *
	 * @return string
	 */
	public function getName()
	{
		return $this->action['as'] ?? null;
	}

	/**
	 * Get the url of the current route.
	 *
	 * @return array
	 */
	public function getRoute()
	{
		return $this->uri;
	}

	/**
	 * Get or set the domain for the route.
	 * 
	 * @param  string|null  $domain  
	 * 
	 * @return $this
	 */
	public function domain($domain = null)
	{
		if (is_null($domain)) {
			return $this->getDomain();

		}

		$this->action['domain'] = $this->parseRoute($domain);

		return $this;
	}

	/**
	 * Get the domain defined for the route.
	 * 
	 * @return string|null
	 */
	public function getDomain()
	{
		return isset($this->action['domain'])
				? str_replace(['http://', 'https://'], '', $this->action['domain'])
				: null;
	}

	/**
	 * Parse the controller.
	 * 
	 * @return array
	 */
	public function parseControllerCallback()
	{
		return Str::parseCallback($this->action['uses']);
	}
	
	/**
	 * Checks whether the route's action is a controller.
	 * 
	 * @return bool
	 */
	public function isControllerAction()
	{
		return is_string($this->action['uses']);
	}

	/**
	 * Get the dispatcher for the route's controller.
	 * 
	 * @return \Syscodes\Controller\ControllerDispatcher
	 */
	private function controllerDispatcher()
	{
		return new ControllerDispatcher($this->container);
	}

	// Setters
	
	/**
	 * Run the route action and return the response.
	 * 
	 * @return mixed
	 */
	public function runResolver()
	{
		$this->container = $this->container ?: new Container;

		try {
			if ($this->isControllerAction()) {
				return $this->runResolverController();
			}

			return $this->runResolverCallable();
		} catch (HttpResponseException $e) {
			return $e->getResponse();
		}
	}

	/**
	 * Run the route action and return the response.
	 *  
	 * @return mixed
	 */
	protected function runResolverCallable()
	{
		$callable = $this->action['uses'];

		return $callable(...array_values($this->resolveMethodDependencies(
			$this->parametersWithouNulls(), new ReflectionFunction($this->action['uses'])
		)));
	}

	/**
	 * Run the route action and return the response.
	 * 
	 * @return mixed
	 */
	protected function runResolverController()
	{
		return $this->controllerDispatcher()->dispatch($this, $this->getController(), $this->getControllerMethod());
	}

	/**
	 * Set the action.
	 *
	 * @param  \Closure|string  $action
	 *
	 * @return $this
	 *
	 * @throws \InvalidArgumentException
	 */
	public function parseAction($action)
	{
		if ( ! (is_object($action) && ($action instanceof Closure)) && ($action === null || $action === '')) {
			throw new InvalidArgumentException(__('route.actionClosureOrFunction'));
		}

		return RouteAction::parse($this->uri, $action);

	}

	/**
	 * Set the method of the current route.
	 *
	 * @param  array  $method
	 *
	 * @return string $this
	 * 
	 * @throws \InvalidArgumentException
	 */
	public function parseMethod($method)
	{
		if ($method === null || empty($method)) {
			throw new InvalidArgumentException(__('route.methodNotProvided'));			
		}

		foreach ((array) $method as $httpMethod) {
			if ( ! in_array($httpMethod, ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS', 'HEAD', 'ANY'])) {
				throw new InvalidArgumentException(__('route.methodNotAllowed'));				
			}
		}

	    return $method;

	}

	/**
	 * Set the route.
	 *
	 * @param  string|array|null  $uri
	 *
	 * @return string
	 *
	 * @throws  \InvalidArgumentException
	 */
	public function parseRoute($uri)
	{
		if ($uri === null) {
			throw new InvalidArgumentException(__('route.uriNotProvided'));
		}	

		$this->uri = $this->parseRoutePath($uri);
		$this->uri = $this->parseRoutePath(/** @scrutinizer ignore-type */ $uri);

		return $this;

	}

	/**
	 * Replace word patterns with regex in route uri.
	 * 
	 * @param  string  $uri
	 * 
	 * @return string
	 */
	protected function parseRoutePath($uri)
	{
		$uri = trim($uri, '\/?');
		$uri = trim($uri, '\/');
		
		preg_match_all('/\{([\w\:]+?)\??\}/', $uri, $matches);
		
		foreach ($matches[1] as $match) {
			if (strpos($match, ':') === false) {
				continue;
			}
			
			$pattern  = array_keys($this->patterns);
			$replace  = array_values($this->patterns);
			$segments = explode(':', trim($match, '{}?'));
			
			$uri = strpos($match, ':') !== false
					? preg_replace($pattern, $replace, $uri)
					: str_replace($match, '{'.$segments[0].'}', $uri);
		}
		
		return $uri;
	}

	/**
	 * Add a prefix to the route URI.
	 * 
	 * @param  string  $prefix
	 * 
	 * @return $this
	 */
	public function prefix($prefix)
	{
		if ( ! empty($newPrefix = trim(rtrim($prefix, '/').'/'.ltrim($this->action['prefix'] ?? '', '/'), '/'))) {
			$this->action['prefix'] = $newPrefix;
		}
		
		$uri = rtrim($prefix, '/').'/'.ltrim($this->uri, '/');
		$uri = rtrim($prefix, '/').'/'.ltrim(/** @scrutinizer ignore-type */ $this->uri, '/');
		
		return $this->parseRoute($uri !== '/' ? trim($uri, '/') : $uri);

	}

	/**
	 * Set the action array for the route.
	 * 
	 * @param  array  $action
	 * 
	 * @return $this
	 */
	public function setAction(array $action)
	{
		$this->action = $action;

		if (isset($this->action['domain'])) {
			$this->domain($this->action['domain']);
		}
		
		return $this;
	}

	/**
	 * Set the name.
	 *
	 * @param  string  $name
	 *
	 * @return $this
	 */
	public function name($name)
	{
		$this->action['as'] = isset($this->action['as']) ? $this->action['as'].$name : $name;

		return $this;
	}

	/**
	 * Determine whether the route's name matches the given patterns.
	 * 
	 * @param  mixed  ...$patterns
	 * 
	 * @return bool
	 */
	public function named(...$patterns)
	{
		if (is_null($routeName = $this->getName())) {

			return false;
		}

		foreach ($patterns as $pattern) {
			if (Str::is($pattern, $routeName)) {
				return true;
			}
		}

		return false;
	}

	/**
	 * Set a default value for the route.
	 * 
	 * @param  string  $key
	 * @param  mixed   $value
	 * 
	 * @return $this
	 */
	public function defaults($key, $value)
	{
		$this->defaults[$key] = $value;

		return $this;
	}

	/**
	 * Set a default values for the route.
	 * 
	 * @param  string  $defaults
	 * 
	 * @return $this
	 */
	public function setDefaults(array $defaults)
	{
		$this->defaults = $defaults;

		return $this;
	}

	/**
	 * Set the where.
	 *
	 * @param  array|string  $name
	 * @param  string|null  $expression  
	 *
	 * @return $this
	 */
	public function where($name, string $expression = null)
	{
		$wheres = is_array($name) ? $name : [$name => $expression];
		
		foreach ($wheres as $name => $expression) {

			$this->wheres[$name] = $expression;
		}

		return $this;
	}

	/**
	 * Bind the route to a given request for execution.
	 * 
	 * @param  \Syscodes\Http\Request  $request
	 * 
	 * @return $this
	 */
	public function bind(Request $request)
	{
		$this->parameters = (new RouteParamBinding($this))->parameters($request);

		return $this;
	}

	/**
	 * Get all of the parameter names for the route.
	 * 
	 * @return array
	 */
	public function parameterNames()
	{
		if (isset($this->parameterNames)) {
			return $this->parameterNames;

		}

		return $this->parameterNames = $this->compileParamNames();

	}

	/**
	 * Get the parameter names for the route.
	 * 
	 * @return array
	 */
	protected function compileParamNames()
	{
		preg_match_all('~[^\/\{(.*?)\}]~', $this->domain().$this->uri, $matches);
		preg_match_all('~[^\/\{(.*?)\}]~', /** @scrutinizer ignore-type */ $this->domain().$this->uri, $matches);

		return array_map(function ($match) {
			return trim($match, '?');
		}, $matches[0]);
	}

	/**
	 * Get a given parameter from the route.
	 * 
	 * @param  string  $name
	 * @param  mixed  $default  
	 * 
	 * @return array
	 */
	public function parameter($name, $default = null)
	{
		return Arr::get($this->parameters(), $name, $default);
	}

	/**
	 * Set a parameter to the given value.
	 * 
	 * @param  string  $name
	 * @param  mixed  $value
	 * 
	 * @return array
	 */
	public function setParameter($name, $value)
	{
		$this->parameters();

		$this->parameters[$name] = $value;
	}

	/**
	 * Get the key / value list of parameters without null values.
	 * 
	 * @return array
	 */
	public function parametersWithouNulls()
	{
		return array_filter($this->parameters(), function ($parameter) {
			return ! is_null($parameter);
		});
	}

	/**
	 * Get the key / value list of parameters for the route.
	 * 
	 * @return array
	 */
	public function parameters()
	{
		if (isset($this->parameters)) {
			return $this->parameters;
		}

		throw new LogicException('The route is not bound.');
	}

	/**
	 * Get all middleware, including the ones from the controller.
	 * 
	 * @return array
	 */
	public function gatherMiddleware()
	{
		if ( ! is_null($this->computedMiddleware)) {
			return $this->computedMiddleware;
		}

		$this->computedMiddleware = [];

		return $this->computedMiddleware = array_unique(array_merge(
			$this->middleware(),
			$this->controllerMiddleware()
		), SORT_REGULAR);
	}

	/**
	 * Get or set the middlewares attached to the route.
	 * 
	 * @param  array|string|null  $middleware
	 * 
	 * @return $this|array
	 */
	public function middleware($middleware = null)
	{
		if (is_null($middleware)) {
			return $this->getMiddleware();
		}

		if (is_string($middleware)) {
			$middleware = func_get_args();
		}

		$this->action['middleware'] = array_merge(
			$this->getMiddleware(),
			$middleware
		);

		return $this;
	}

	/**
	 * Get the middlewares attached to the route.
	 * 
	 * @return array
	 */
	protected function getMiddleware()
	{
		return (array) ($this->action['middleware'] ?? []);
	}

	/**
	 * Get the middleware for the route's controller.
	 * 
	 * @return array
	 */
	public function controllerMiddleware()
	{
		if ( ! $this->isControllerAction()) {
			return [];
		}

		return $this->controllerDispatcher()->getMiddleware(
			$this->getController(),
			/** @scrutinizer ignore-type */ $this->getController(),
			$this->getControllerMethod()
		);
	}

	/**
	 * Determine if the route only responds to HTTP requests.
	 * 
	 * @return bool
	 */
	public function httpOnly()
	{
		return in_array('http', $this->action, true);
	}

	/**
	 * Determine if the route only responds to HTTPS requests.
	 * 
	 * @return bool
	 */
	public function httpsOnly()
	{
		return $this->secure();
	}

	/**
	 * Determine if the route only responds to HTTPS requests.
	 * 
	 * @return bool
	 */
	public function secure()
	{
		return in_array('https', $this->action, true);
	}

	/**
	 * Set the container instance on the route.
	 * 
	 * @param  \Syscodes\Container\Container  $container
	 * 
	 * @return $this
	 */
	public function setContainer(Container $container)
	{
		$this->container = $container;

		return $this;
	}

	/**
	 * Dynamically access route parameters.
	 * 
	 * @param  string  $key
	 * 
	 * @return mixed
	 */
	public function __get($key)
	{
		return $this->parameter($key);
	}
}
lenevor / syscodes

Route::name() A last analyzed 2021-03-26 23:28 UTC

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like

Route::name() A
last analyzed 2021-03-26 23:28 UTC
