codeburnerframework / routing

src/Collectors/ControllerCollectorTrait.php

Indentation +229 added lines, -229 removed lines

@@ -26,235 +26,235 @@
 trait ControllerCollectorTrait
 {
 
-    /**
-     * @return Parser
-     */
-
-    abstract public function getParser();
-
-    /**
-     * @param string $method
-     * @param string $pattern
-     * @param callable $action
-     *
-     * @return Group
-     */
-
-    abstract public function set($method, $pattern, $action);
-
-    /**
-     * Define how controller actions names will be joined to form the route pattern.
-     *
-     * @var string
-     */
-
-    protected $controllerActionJoin = "/";
-
-    /**
-     * Maps all the controller methods that begins with a HTTP method, and maps the rest of
-     * name as a path. The path will be the method name with slashes before every camelcased 
-     * word and without the HTTP method prefix, and the controller name will be used to prefix
-     * the route pattern. e.g. ArticlesController::getCreate will generate a route to: GET articles/create
-     *
-     * @param string $controller The controller name
-     * @param string $prefix
-     *
-     * @throws \ReflectionException
-     * @return Group
-     */
-
-    public function controller($controller, $prefix = null)
-    {
-        $controller = new ReflectionClass($controller);
-        $prefix     = $prefix === null ? $this->getControllerPrefix($controller) : $prefix;
-        $methods    = $controller->getMethods(ReflectionMethod::IS_PUBLIC);
-        return $this->collectControllerRoutes($controller, $methods, "/$prefix/");
-    }
-
-    /**
-     * Maps several controllers at same time.
-     *
-     * @param string[] $controllers Controllers name.
-     * @throws \ReflectionException
-     * @return Group
-     */
-
-    public function controllers(array $controllers)
-    {
-        $group = new Group;
-        foreach ($controllers as $controller)
-            $group->set($this->controller($controller));
-        return $group;
-    }
-
-    /**
-     * Alias for Collector::controller but maps a controller without using the controller name as prefix.
-     *
-     * @param string $controller The controller name
-     * @throws \ReflectionException
-     * @return Group
-     */
-
-    public function controllerWithoutPrefix($controller)
-    {
-        $controller = new ReflectionClass($controller);
-        $methods = $controller->getMethods(ReflectionMethod::IS_PUBLIC);
-        return $this->collectControllerRoutes($controller, $methods, "/");
-    }
-
-    /**
-     * Alias for Collector::controllers but maps a controller without using the controller name as prefix.
-     *
-     * @param string[] $controllers
-     * @throws \ReflectionException
-     * @return Group
-     */
-
-    public function controllersWithoutPrefix(array $controllers)
-    {
-        $group = new Group;
-        foreach ($controllers as $controller)
-            $group->set($this->controllerWithoutPrefix($controller));
-        return $group;
-    }
-
-    /**
-     * @param ReflectionClass $controller
-     * @param ReflectionMethod[] $methods
-     * @param string $prefix
-     *
-     * @return Group
-     */
-
-    protected function collectControllerRoutes(ReflectionClass $controller, array $methods, $prefix)
-    {
-        $group = new Group;
-        $controllerDefaultStrategy = $this->getAnnotatedStrategy($controller);
-
-        foreach ($methods as $method) {
-            $name = preg_split("~(?=[A-Z])~", $method->name);
-            $http = $name[0];
-            unset($name[0]);
+	/**
+	 * @return Parser
+	 */
+
+	abstract public function getParser();
+
+	/**
+	 * @param string $method
+	 * @param string $pattern
+	 * @param callable $action
+	 *
+	 * @return Group
+	 */
+
+	abstract public function set($method, $pattern, $action);
+
+	/**
+	 * Define how controller actions names will be joined to form the route pattern.
+	 *
+	 * @var string
+	 */
+
+	protected $controllerActionJoin = "/";
+
+	/**
+	 * Maps all the controller methods that begins with a HTTP method, and maps the rest of
+	 * name as a path. The path will be the method name with slashes before every camelcased 
+	 * word and without the HTTP method prefix, and the controller name will be used to prefix
+	 * the route pattern. e.g. ArticlesController::getCreate will generate a route to: GET articles/create
+	 *
+	 * @param string $controller The controller name
+	 * @param string $prefix
+	 *
+	 * @throws \ReflectionException
+	 * @return Group
+	 */
+
+	public function controller($controller, $prefix = null)
+	{
+		$controller = new ReflectionClass($controller);
+		$prefix     = $prefix === null ? $this->getControllerPrefix($controller) : $prefix;
+		$methods    = $controller->getMethods(ReflectionMethod::IS_PUBLIC);
+		return $this->collectControllerRoutes($controller, $methods, "/$prefix/");
+	}
+
+	/**
+	 * Maps several controllers at same time.
+	 *
+	 * @param string[] $controllers Controllers name.
+	 * @throws \ReflectionException
+	 * @return Group
+	 */
+
+	public function controllers(array $controllers)
+	{
+		$group = new Group;
+		foreach ($controllers as $controller)
+			$group->set($this->controller($controller));
+		return $group;
+	}
+
+	/**
+	 * Alias for Collector::controller but maps a controller without using the controller name as prefix.
+	 *
+	 * @param string $controller The controller name
+	 * @throws \ReflectionException
+	 * @return Group
+	 */
+
+	public function controllerWithoutPrefix($controller)
+	{
+		$controller = new ReflectionClass($controller);
+		$methods = $controller->getMethods(ReflectionMethod::IS_PUBLIC);
+		return $this->collectControllerRoutes($controller, $methods, "/");
+	}
+
+	/**
+	 * Alias for Collector::controllers but maps a controller without using the controller name as prefix.
+	 *
+	 * @param string[] $controllers
+	 * @throws \ReflectionException
+	 * @return Group
+	 */
+
+	public function controllersWithoutPrefix(array $controllers)
+	{
+		$group = new Group;
+		foreach ($controllers as $controller)
+			$group->set($this->controllerWithoutPrefix($controller));
+		return $group;
+	}
+
+	/**
+	 * @param ReflectionClass $controller
+	 * @param ReflectionMethod[] $methods
+	 * @param string $prefix
+	 *
+	 * @return Group
+	 */
+
+	protected function collectControllerRoutes(ReflectionClass $controller, array $methods, $prefix)
+	{
+		$group = new Group;
+		$controllerDefaultStrategy = $this->getAnnotatedStrategy($controller);
+
+		foreach ($methods as $method) {
+			$name = preg_split("~(?=[A-Z])~", $method->name);
+			$http = $name[0];
+			unset($name[0]);
  
-            if (strpos(Collector::HTTP_METHODS, $http) !== false) {
-                $action   = $prefix . strtolower(implode($this->controllerActionJoin, $name));
-                $dynamic  = $this->getMethodConstraints($method);
-                $strategy = $this->getAnnotatedStrategy($method);
-
-                $route = $this->set($http, "$action$dynamic", [$controller->name, $method->name]);
-
-                if ($strategy !== null) {
-                       $route->setStrategy($strategy);
-                } else $route->setStrategy($controllerDefaultStrategy);
-
-                $group->set($route);
-            }
-        }
-
-        return $group;
-    }
-
-    /**
-     * @param ReflectionClass $controller
-     *
-     * @return string
-     */
-
-    protected function getControllerPrefix(ReflectionClass $controller)
-    {
-        preg_match("~\@prefix\s([a-zA-Z\\\_]+)~i", (string) $controller->getDocComment(), $prefix);
-        return isset($prefix[1]) ? $prefix[1] : str_replace("controller", "", strtolower($controller->getShortName()));
-    }
-
-    /**
-     * @param \ReflectionMethod
-     * @return string
-     */
-
-    protected function getMethodConstraints(ReflectionMethod $method)
-    {
-        $beginPath = "";
-        $endPath = "";
-
-        if ($parameters = $method->getParameters()) {
-            $types = $this->getParamsConstraint($method);
-
-            foreach ($parameters as $parameter) {
-                if ($parameter->isOptional()) {
-                    $beginPath .= "[";
-                    $endPath .= "]";
-                }
-
-                $beginPath .= $this->getPathConstraint($parameter, $types);
-            }
-        }
-
-        return $beginPath . $endPath;
-    }
-
-    /**
-     * @param ReflectionParameter $parameter
-     * @param string[] $types
-     * @return string
-     */
-
-    protected function getPathConstraint(ReflectionParameter $parameter, $types)
-    {
-        $name = $parameter->name;
-        $path = "/{" . $name;
-        return isset($types[$name]) ? "$path:{$types[$name]}}" : "$path}";
-    }
-
-    /**
-     * @param ReflectionMethod $method
-     * @return string[]
-     */
-
-    protected function getParamsConstraint(ReflectionMethod $method)
-    {
-        $params = [];
-        preg_match_all("~\@param\s(" . implode("|", array_keys($this->getParser()->getWildcards())) . "|\(.+\))\s\\$([a-zA-Z0-1_]+)~i",
-            $method->getDocComment(), $types, PREG_SET_ORDER);
-
-        foreach ((array) $types as $type) {
-            // if a pattern is defined on Match take it otherwise take the param type by PHPDoc.
-            $params[$type[2]] = isset($type[4]) ? $type[4] : $type[1];
-        }
-
-        return $params;
-    }
-
-    /**
-     * @param ReflectionClass|ReflectionMethod $reflector
-     * @return string|null
-     */
-
-    protected function getAnnotatedStrategy($reflector)
-    {
-        preg_match("~\@strategy\s([a-zA-Z\\\_]+)~i", (string) $reflector->getDocComment(), $strategy);
-        return isset($strategy[1]) ? $strategy[1] : null;
-    }
-
-    /**
-     * Define how controller actions names will be joined to form the route pattern.
-     * Defaults to "/" so actions like "getMyAction" will be "/my/action". If changed to
-     * "-" the new pattern will be "/my-action".
-     *
-     * @param string $join
-     */
-
-    public function setControllerActionJoin($join)
-    {
-        $this->controllerActionJoin = $join;
-    }
-
-    /**
-     * @return string
-     */
-
-    public function getControllerActionJoin()
-    {
-        return $this->controllerActionJoin;
-    }
+			if (strpos(Collector::HTTP_METHODS, $http) !== false) {
+				$action   = $prefix . strtolower(implode($this->controllerActionJoin, $name));
+				$dynamic  = $this->getMethodConstraints($method);
+				$strategy = $this->getAnnotatedStrategy($method);
+
+				$route = $this->set($http, "$action$dynamic", [$controller->name, $method->name]);
+
+				if ($strategy !== null) {
+					   $route->setStrategy($strategy);
+				} else $route->setStrategy($controllerDefaultStrategy);
+
+				$group->set($route);
+			}
+		}
+
+		return $group;
+	}
+
+	/**
+	 * @param ReflectionClass $controller
+	 *
+	 * @return string
+	 */
+
+	protected function getControllerPrefix(ReflectionClass $controller)
+	{
+		preg_match("~\@prefix\s([a-zA-Z\\\_]+)~i", (string) $controller->getDocComment(), $prefix);
+		return isset($prefix[1]) ? $prefix[1] : str_replace("controller", "", strtolower($controller->getShortName()));
+	}
+
+	/**
+	 * @param \ReflectionMethod
+	 * @return string
+	 */
+
+	protected function getMethodConstraints(ReflectionMethod $method)
+	{
+		$beginPath = "";
+		$endPath = "";
+
+		if ($parameters = $method->getParameters()) {
+			$types = $this->getParamsConstraint($method);
+
+			foreach ($parameters as $parameter) {
+				if ($parameter->isOptional()) {
+					$beginPath .= "[";
+					$endPath .= "]";
+				}
+
+				$beginPath .= $this->getPathConstraint($parameter, $types);
+			}
+		}
+
+		return $beginPath . $endPath;
+	}
+
+	/**
+	 * @param ReflectionParameter $parameter
+	 * @param string[] $types
+	 * @return string
+	 */
+
+	protected function getPathConstraint(ReflectionParameter $parameter, $types)
+	{
+		$name = $parameter->name;
+		$path = "/{" . $name;
+		return isset($types[$name]) ? "$path:{$types[$name]}}" : "$path}";
+	}
+
+	/**
+	 * @param ReflectionMethod $method
+	 * @return string[]
+	 */
+
+	protected function getParamsConstraint(ReflectionMethod $method)
+	{
+		$params = [];
+		preg_match_all("~\@param\s(" . implode("|", array_keys($this->getParser()->getWildcards())) . "|\(.+\))\s\\$([a-zA-Z0-1_]+)~i",
+			$method->getDocComment(), $types, PREG_SET_ORDER);
+
+		foreach ((array) $types as $type) {
+			// if a pattern is defined on Match take it otherwise take the param type by PHPDoc.
+			$params[$type[2]] = isset($type[4]) ? $type[4] : $type[1];
+		}
+
+		return $params;
+	}
+
+	/**
+	 * @param ReflectionClass|ReflectionMethod $reflector
+	 * @return string|null
+	 */
+
+	protected function getAnnotatedStrategy($reflector)
+	{
+		preg_match("~\@strategy\s([a-zA-Z\\\_]+)~i", (string) $reflector->getDocComment(), $strategy);
+		return isset($strategy[1]) ? $strategy[1] : null;
+	}
+
+	/**
+	 * Define how controller actions names will be joined to form the route pattern.
+	 * Defaults to "/" so actions like "getMyAction" will be "/my/action". If changed to
+	 * "-" the new pattern will be "/my-action".
+	 *
+	 * @param string $join
+	 */
+
+	public function setControllerActionJoin($join)
+	{
+		$this->controllerActionJoin = $join;
+	}
+
+	/**
+	 * @return string
+	 */
+
+	public function getControllerActionJoin()
+	{
+		return $this->controllerActionJoin;
+	}
 
 }

src/Matcher.php

Indentation +273 added lines, -273 removed lines

@@ -23,279 +23,279 @@
 class Matcher
 {
 
-    /**
-     * @var Collector
-     */
-
-    protected $collector;
-
-    /**
-     * @var Parser $parser
-     */
-
-    protected $parser;
-
-    /**
-     * Define a basepath to all routes.
-     *
-     * @var string
-     */
-
-    protected $basepath = "";
-
-    /**
-     * Construct the route dispatcher.
-     *
-     * @param Collector $collector
-     * @param string $basepath Define a Path prefix that must be excluded on matches.
-     */
-
-    public function __construct(Collector $collector, $basepath = "")
-    {
-        $this->collector = $collector;
-        $this->basepath  = $basepath;
-    }
-
-    /**
-     * Find a route that matches the given arguments.
-     * 
-     * @param string $httpMethod
-     * @param string $path
-     *
-     * @throws NotFoundException
-     * @throws MethodNotAllowedException
-     *
-     * @return Route
-     */
-
-    public function match($httpMethod, $path)
-    {
-        $path = $this->parsePath($path);
-
-        if (($route = $this->collector->findStaticRoute($httpMethod, $path)) ||
-            ($route = $this->matchDynamicRoute($httpMethod, $path))) {
-             $route->setMatcher($this);
-
-            return $route;
-        }
-
-        $this->matchSimilarRoute($httpMethod, $path);
-    }
-
-    /**
-     * Find and return the request dynamic route based on the compiled data and Path.
-     *
-     * @param string $httpMethod
-     * @param string $path
-     *
-     * @return Route|false If the request match an array with the action and parameters will
-     *                     be returned otherwise a false will.
-     */
-
-    protected function matchDynamicRoute($httpMethod, $path)
-    {
-        if ($routes = $this->collector->findDynamicRoutes($httpMethod, $path)) {
-            // cache the parser reference
-            $this->parser = $this->collector->getParser();
-            // chunk routes for smaller regex groups using the Sturges' Formula
-            foreach (array_chunk($routes, round(1 + 3.3 * log(count($routes))), true) as $chunk) {
-                array_map([$this, "buildRoute"], $chunk);
-                list($pattern, $map) = $this->buildGroup($chunk);
-
-                if (!preg_match($pattern, $path, $matches)) {
-                    continue;
-                }
-
-                /** @var Route $route */
-                $route = $map[count($matches)];
-                unset($matches[0]);
-
-                $route->setParams(array_combine($route->getParams(), array_filter($matches)));
-
-                return $route;
-            }
-        }
-
-        return false;
-    }
-
-    /**
-     * Parse the dynamic segments of the pattern and replace then for
-     * corresponding regex.
-     *
-     * @param Route $route
-     * @return Route
-     */
-
-    protected function buildRoute(Route $route)
-    {
-        if ($route->getBlock()) {
-            return $route;
-        }
-
-        list($pattern, $params) = $this->parsePlaceholders($route->getPattern());
-        return $route->setPatternWithoutReset($pattern)->setParams($params)->setBlock(true);
-    }
-
-    /**
-     * Group several dynamic routes patterns into one big regex and maps
-     * the routes to the pattern positions in the big regex.
-     *
-     * @param Route[] $routes
-     * @return array
-     */
-
-    protected function buildGroup(array $routes)
-    {
-        $groupCount = (int) $map = $regex = [];
-
-        foreach ($routes as $route) {
-            $params           = $route->getParams();
-            $paramsCount      = count($params);
-            $groupCount       = max($groupCount, $paramsCount) + 1;
-            $regex[]          = $route->getPattern() . str_repeat("()", $groupCount - $paramsCount - 1);
-            $map[$groupCount] = $route;
-        }
-
-        return ["~^(?|" . implode("|", $regex) . ")$~", $map];
-    }
-
-    /**
-     * Parse an route pattern seeking for parameters and build the route regex.
-     *
-     * @param string $pattern
-     * @return array 0 => new route regex, 1 => map of parameter names
-     */
-
-    protected function parsePlaceholders($pattern)
-    {
-        $params = [];
-        $parser = $this->parser;
-
-        preg_match_all("~" . $parser::DYNAMIC_REGEX . "~x", $pattern, $matches, PREG_SET_ORDER);
-
-        foreach ((array) $matches as $key => $match) {
-            $pattern = str_replace($match[0], isset($match[2]) ? "({$match[2]})" : "([^/]+)", $pattern);
-            $params[$key] = $match[1];
-        }
-
-        return [$pattern, $params];
-    }
-
-    /**
-     * Get only the path of a given url.
-     *
-     * @param string $path The given URL
-     *
-     * @throws Exception
-     * @return string
-     */
-
-    protected function parsePath($path)
-    {
-        $path = parse_url(substr(strstr(";" . $path, ";" . $this->basepath), strlen(";" . $this->basepath)), PHP_URL_PATH);
-
-        if ($path === false) {
-            throw new Exception("Seriously malformed URL passed to route matcher.");
-        }
-
-        return $path;
-    }
-
-    /**
-     * Generate an HTTP error request with method not allowed or not found.
-     *
-     * @param string $httpMethod
-     * @param string $path
-     *
-     * @throws NotFoundException
-     * @throws MethodNotAllowedException
-     */
-
-    protected function matchSimilarRoute($httpMethod, $path)
-    {
-        $dm = [];
-
-        if (($sm = $this->checkStaticRouteInOtherMethods($httpMethod, $path))
-                || ($dm = $this->checkDynamicRouteInOtherMethods($httpMethod, $path))) {
-            throw new MethodNotAllowedException($httpMethod, $path, array_merge((array) $sm, (array) $dm));
-        }
-
-        throw new NotFoundException;
-    }
-
-    /**
-     * Verify if a static route match in another method than the requested.
-     *
-     * @param string $targetHttpMethod The HTTP method that must not be checked
-     * @param string $path              The Path that must be matched.
-     *
-     * @return array
-     */
-
-    protected function checkStaticRouteInOtherMethods($targetHttpMethod, $path)
-    {
-        return array_filter($this->getHttpMethodsBut($targetHttpMethod), function ($httpMethod) use ($path) {
-            return (bool) $this->collector->findStaticRoute($httpMethod, $path);
-        });
-    }
-
-    /**
-     * Verify if a dynamic route match in another method than the requested.
-     *
-     * @param string $targetHttpMethod The HTTP method that must not be checked
-     * @param string $path             The Path that must be matched.
-     *
-     * @return array
-     */
-
-    protected function checkDynamicRouteInOtherMethods($targetHttpMethod, $path)
-    {
-        return array_filter($this->getHttpMethodsBut($targetHttpMethod), function ($httpMethod) use ($path) {
-            return (bool) $this->matchDynamicRoute($httpMethod, $path);
-        });
-    }
-
-    /**
-     * Strip the given http methods and return all the others.
-     *
-     * @param string|string[]
-     * @return array
-     */
-
-    protected function getHttpMethodsBut($targetHttpMethod)
-    {
-        return array_diff(explode(" ", Collector::HTTP_METHODS), (array) $targetHttpMethod);
-    }
-
-    /**
-     * @return Collector
-     */
-
-    public function getCollector()
-    {
-        return $this->collector;
-    }
-
-    /**
-     * @return string
-     */
-
-    public function getBasePath()
-    {
-        return $this->basepath;
-    }
-
-    /**
-     * Set a new basepath, this will be a prefix that must be excluded in
-     * every requested Path.
-     *
-     * @param string $basepath The new basepath
-     */
+	/**
+	 * @var Collector
+	 */
+
+	protected $collector;
+
+	/**
+	 * @var Parser $parser
+	 */
+
+	protected $parser;
+
+	/**
+	 * Define a basepath to all routes.
+	 *
+	 * @var string
+	 */
+
+	protected $basepath = "";
+
+	/**
+	 * Construct the route dispatcher.
+	 *
+	 * @param Collector $collector
+	 * @param string $basepath Define a Path prefix that must be excluded on matches.
+	 */
+
+	public function __construct(Collector $collector, $basepath = "")
+	{
+		$this->collector = $collector;
+		$this->basepath  = $basepath;
+	}
+
+	/**
+	 * Find a route that matches the given arguments.
+	 * 
+	 * @param string $httpMethod
+	 * @param string $path
+	 *
+	 * @throws NotFoundException
+	 * @throws MethodNotAllowedException
+	 *
+	 * @return Route
+	 */
+
+	public function match($httpMethod, $path)
+	{
+		$path = $this->parsePath($path);
+
+		if (($route = $this->collector->findStaticRoute($httpMethod, $path)) ||
+			($route = $this->matchDynamicRoute($httpMethod, $path))) {
+			 $route->setMatcher($this);
+
+			return $route;
+		}
+
+		$this->matchSimilarRoute($httpMethod, $path);
+	}
+
+	/**
+	 * Find and return the request dynamic route based on the compiled data and Path.
+	 *
+	 * @param string $httpMethod
+	 * @param string $path
+	 *
+	 * @return Route|false If the request match an array with the action and parameters will
+	 *                     be returned otherwise a false will.
+	 */
+
+	protected function matchDynamicRoute($httpMethod, $path)
+	{
+		if ($routes = $this->collector->findDynamicRoutes($httpMethod, $path)) {
+			// cache the parser reference
+			$this->parser = $this->collector->getParser();
+			// chunk routes for smaller regex groups using the Sturges' Formula
+			foreach (array_chunk($routes, round(1 + 3.3 * log(count($routes))), true) as $chunk) {
+				array_map([$this, "buildRoute"], $chunk);
+				list($pattern, $map) = $this->buildGroup($chunk);
+
+				if (!preg_match($pattern, $path, $matches)) {
+					continue;
+				}
+
+				/** @var Route $route */
+				$route = $map[count($matches)];
+				unset($matches[0]);
+
+				$route->setParams(array_combine($route->getParams(), array_filter($matches)));
+
+				return $route;
+			}
+		}
+
+		return false;
+	}
+
+	/**
+	 * Parse the dynamic segments of the pattern and replace then for
+	 * corresponding regex.
+	 *
+	 * @param Route $route
+	 * @return Route
+	 */
+
+	protected function buildRoute(Route $route)
+	{
+		if ($route->getBlock()) {
+			return $route;
+		}
+
+		list($pattern, $params) = $this->parsePlaceholders($route->getPattern());
+		return $route->setPatternWithoutReset($pattern)->setParams($params)->setBlock(true);
+	}
+
+	/**
+	 * Group several dynamic routes patterns into one big regex and maps
+	 * the routes to the pattern positions in the big regex.
+	 *
+	 * @param Route[] $routes
+	 * @return array
+	 */
+
+	protected function buildGroup(array $routes)
+	{
+		$groupCount = (int) $map = $regex = [];
+
+		foreach ($routes as $route) {
+			$params           = $route->getParams();
+			$paramsCount      = count($params);
+			$groupCount       = max($groupCount, $paramsCount) + 1;
+			$regex[]          = $route->getPattern() . str_repeat("()", $groupCount - $paramsCount - 1);
+			$map[$groupCount] = $route;
+		}
+
+		return ["~^(?|" . implode("|", $regex) . ")$~", $map];
+	}
+
+	/**
+	 * Parse an route pattern seeking for parameters and build the route regex.
+	 *
+	 * @param string $pattern
+	 * @return array 0 => new route regex, 1 => map of parameter names
+	 */
+
+	protected function parsePlaceholders($pattern)
+	{
+		$params = [];
+		$parser = $this->parser;
+
+		preg_match_all("~" . $parser::DYNAMIC_REGEX . "~x", $pattern, $matches, PREG_SET_ORDER);
+
+		foreach ((array) $matches as $key => $match) {
+			$pattern = str_replace($match[0], isset($match[2]) ? "({$match[2]})" : "([^/]+)", $pattern);
+			$params[$key] = $match[1];
+		}
+
+		return [$pattern, $params];
+	}
+
+	/**
+	 * Get only the path of a given url.
+	 *
+	 * @param string $path The given URL
+	 *
+	 * @throws Exception
+	 * @return string
+	 */
+
+	protected function parsePath($path)
+	{
+		$path = parse_url(substr(strstr(";" . $path, ";" . $this->basepath), strlen(";" . $this->basepath)), PHP_URL_PATH);
+
+		if ($path === false) {
+			throw new Exception("Seriously malformed URL passed to route matcher.");
+		}
+
+		return $path;
+	}
+
+	/**
+	 * Generate an HTTP error request with method not allowed or not found.
+	 *
+	 * @param string $httpMethod
+	 * @param string $path
+	 *
+	 * @throws NotFoundException
+	 * @throws MethodNotAllowedException
+	 */
+
+	protected function matchSimilarRoute($httpMethod, $path)
+	{
+		$dm = [];
+
+		if (($sm = $this->checkStaticRouteInOtherMethods($httpMethod, $path))
+				|| ($dm = $this->checkDynamicRouteInOtherMethods($httpMethod, $path))) {
+			throw new MethodNotAllowedException($httpMethod, $path, array_merge((array) $sm, (array) $dm));
+		}
+
+		throw new NotFoundException;
+	}
+
+	/**
+	 * Verify if a static route match in another method than the requested.
+	 *
+	 * @param string $targetHttpMethod The HTTP method that must not be checked
+	 * @param string $path              The Path that must be matched.
+	 *
+	 * @return array
+	 */
+
+	protected function checkStaticRouteInOtherMethods($targetHttpMethod, $path)
+	{
+		return array_filter($this->getHttpMethodsBut($targetHttpMethod), function ($httpMethod) use ($path) {
+			return (bool) $this->collector->findStaticRoute($httpMethod, $path);
+		});
+	}
+
+	/**
+	 * Verify if a dynamic route match in another method than the requested.
+	 *
+	 * @param string $targetHttpMethod The HTTP method that must not be checked
+	 * @param string $path             The Path that must be matched.
+	 *
+	 * @return array
+	 */
+
+	protected function checkDynamicRouteInOtherMethods($targetHttpMethod, $path)
+	{
+		return array_filter($this->getHttpMethodsBut($targetHttpMethod), function ($httpMethod) use ($path) {
+			return (bool) $this->matchDynamicRoute($httpMethod, $path);
+		});
+	}
+
+	/**
+	 * Strip the given http methods and return all the others.
+	 *
+	 * @param string|string[]
+	 * @return array
+	 */
+
+	protected function getHttpMethodsBut($targetHttpMethod)
+	{
+		return array_diff(explode(" ", Collector::HTTP_METHODS), (array) $targetHttpMethod);
+	}
+
+	/**
+	 * @return Collector
+	 */
+
+	public function getCollector()
+	{
+		return $this->collector;
+	}
+
+	/**
+	 * @return string
+	 */
+
+	public function getBasePath()
+	{
+		return $this->basepath;
+	}
+
+	/**
+	 * Set a new basepath, this will be a prefix that must be excluded in
+	 * every requested Path.
+	 *
+	 * @param string $basepath The new basepath
+	 */
     
-    public function setBasePath($basepath)
-    {
-        $this->basepath = $basepath;
-    }
+	public function setBasePath($basepath)
+	{
+		$this->basepath = $basepath;
+	}
 
 }

src/Route.php

Indentation +616 added lines, -616 removed lines

@@ -23,626 +23,626 @@
 class Route
 {
 
-    /**
-     * @var Collector
-     */
+	/**
+	 * @var Collector
+	 */
 
-    protected $collector;
+	protected $collector;
 
-    /**
-     * @var string
-     */
+	/**
+	 * @var string
+	 */
 
-    protected $method;
+	protected $method;
 
-    /**
-     * @var string
-     */
-
-    protected $pattern;
+	/**
+	 * @var string
+	 */
+
+	protected $pattern;
 
-    /**
-     * @var callable
-     */
-
-    protected $action;
-
-    /**
-     * @var string
-     */
-
-    protected $namespace = "";
-
-    /**
-     * @var string[]
-     */
-
-    protected $params = [];
-
-    /**
-     * Defaults are parameters set by the user, and don't
-     * appear on the pattern.
-     *
-     * @var array
-     */
-
-    protected $defaults = [];
-
-    /**
-     * Metadata can be set to be used on filters, dispatch strategies
-     * or anywhere the route object is used.
-     *
-     * @var array
-     */
-
-    protected $metadata = [];
-
-    /**
-     * @var string|StrategyInterface
-     */
-
-    protected $strategy;
-
-    /**
-     * Blocked routes are dynamic routes selected to pass by the matcher.
-     *
-     * @var boolean
-     */
-
-    protected $blocked = false;
-
-    /**
-     * The matcher that dispatched this route.
-     *
-     * @var Matcher $matcher
-     */
-
-    protected $matcher;
-
-    /**
-     * The function used to create controllers from name.
-     *
-     * @var callable
-     */
-
-    protected $controllerCreationFunction;
-
-    /**
-     * @param Collector $collector
-     * @param string $method
-     * @param string $pattern
-     * @param callable $action
-     */
-
-    public function __construct(Collector $collector, $method, $pattern, $action)
-    {
-        $this->collector = $collector;
-        $this->method    = $method;
-        $this->pattern   = $pattern;
-        $this->action    = $action;
-    }
-
-    /**
-     * Clone this route and set it into the collector.
-     *
-     * @return Route
-     */
-
-    public function reset()
-    {
-        return $this->collector->set($this->method, $this->pattern, $this->action)->nth(0)
-                               ->setStrategy($this->strategy)->setParams($this->params)
-                               ->setDefaults($this->defaults)->setMetadataArray($this->metadata);
-    }
-
-    /**
-     * Remove this route from the collector.
-     *
-     * @return self
-     */
-
-    public function forget()
-    {
-        $this->collector->forget($this->method, $this->pattern);
-        return $this;
-    }
-
-    /**
-     * Execute the route action, if no strategy was provided the action
-     * will be executed by the call_user_func PHP function.
-     *
-     * @param callable $container
-     * @throws BadRouteException
-     * @return mixed
-     */
-
-    public function call(callable $container = null)
-    {
-        $this->action = $this->buildCallable($this->action, $container);
-
-        if ($this->strategy === null) {
-            return call_user_func_array($this->action, array_merge($this->defaults, $this->params));
-        }
-
-        if (!is_object($this->strategy)) {
-            if ($container === null) {
-                   $this->strategy = new $this->strategy;
-            } else $this->strategy = $container($this->strategy);
-        }
-
-        return $this->callWithStrategy();
-    }
-
-    /**
-     * Seek for dynamic content in one callable. This allow to use parameters defined on pattern on callable
-     * definition, eg. "get" "/{resource:string+}/{slug:slug+}" "{resource}::find".
-     *
-     * This will snakecase the resource parameter and deal with as a controller, then call the find method.
-     * A request for "/articles/my-first-article" will execute find method of Articles controller with only
-     * "my-first-article" as parameter.
-     *
-     * @param callable $callable
-     * @param callable $container
-     *
-     * @return callable
-     */
-
-    private function buildCallable($callable, $container = null)
-    {
-        if (is_string($callable) && strpos($callable, "::")) {
-            $callable = explode("::", $callable);
-        }
-
-        if (is_array($callable)) {
-            if (is_string($callable[0])) {
-                   $callable[0] = $this->parseCallableController($callable[0], $container);
-            }
-
-            $callable[1] = $this->parseCallablePlaceholders($callable[1]);
-        }
-
-        return $callable;
-    }
-
-    /**
-     * Get the controller object.
-     *
-     * @param string $controller
-     * @param callable $container
-     *
-     * @return Object
-     */
-
-    private function parseCallableController($controller, $container)
-    {
-        $controller  = rtrim($this->namespace, "\\") . "\\" . $this->parseCallablePlaceholders($controller);
-
-        if ($container === null) {
-               return new $controller;
-        } else return $container($controller);
-    }
-
-    /**
-     * Parse and replace dynamic content on route action.
-     *
-     * @param string $fragment Part of callable
-     * @return string
-     */
-
-    private function parseCallablePlaceholders($fragment)
-    {
-        if (strpos($fragment, "{") !== false) {
-            foreach ($this->params as $placeholder => $value) {
-                if (strpos($fragment, "{" . $placeholder . "}") !== false) {
-                    $fragment = str_replace("{" . $placeholder . "}", ucwords(str_replace("-", " ", $value)), $fragment);
-                }
-            }
-        }
-
-        return $fragment;
-    }
-
-    /**
-     * Execute the route action with the given strategy.
-     *
-     * @throws BadRouteException
-     * @return mixed
-     */
-
-    private function callWithStrategy()
-    {
-        if ($this->strategy instanceof StrategyInterface) {
-            if ($this->strategy instanceof MatcherAwareInterface) {
-                $this->strategy->setMatcher($this->matcher);
-            }
-
-            return $this->strategy->call($this);
-        }
-
-        throw new BadRouteException(str_replace("%s", get_class($this->strategy), BadRouteException::BAD_STRATEGY));
-    }
-
-    /**
-     * @return Collector
-     */
-
-    public function getCollector()
-    {
-        return $this->collector;
-    }
-
-    /**
-     * @return string
-     */
-
-    public function getMethod()
-    {
-        return $this->method;
-    }
-
-    /**
-     * @return string
-     */
-
-    public function getPattern()
-    {
-        return $this->pattern;
-    }
-
-    /**
-     * @return string[]
-     */
-
-    public function getSegments()
-    {
-        return explode("/", $this->pattern);
-    }
-
-    /**
-     * @return callable
-     */
-
-    public function getAction()
-    {
-        return $this->action;
-    }
-
-    /**
-     * @return string
-     */
-
-    public function getNamespace()
-    {
-        return $this->namespace;
-    }
-
-    /**
-     * @return string[]
-     */
-
-    public function getParams()
-    {
-        return $this->params;
-    }
-
-    /**
-     * @param string $key
-     * @return string
-     */
-
-    public function getParam($key)
-    {
-        return $this->params[$key];
-    }
-
-    /**
-     * Return defaults and params merged in one array.
-     *
-     * @return array
-     */
-
-    public function getMergedParams()
-    {
-        return array_merge($this->defaults, $this->params);
-    }
-
-    /**
-     * @return array
-     */
-
-    public function getDefaults()
-    {
-        return $this->defaults;
-    }
-
-    /**
-     * @param string $key
-     * @return mixed
-     */
-
-    public function getDefault($key)
-    {
-        return $this->defaults[$key];
-    }
-
-    /**
-     * @return array
-     */
-
-    public function getMetadataArray()
-    {
-        return $this->metadata;
-    }
-
-    /**
-     * @param string $key
-     * @return mixed
-     */
-
-    public function getMetadata($key)
-    {
-        return $this->metadata[$key];
-    }
-
-    /**
-     * @return string|null
-     */
-
-    public function getStrategy()
-    {
-        if ($this->strategy instanceof StrategyInterface) {
-            return get_class($this->strategy);
-        }
-
-        return $this->strategy;
-    }
-
-    /**
-     * @return StrategyInterface|string
-     */
-
-    public function getRawStrategy()
-    {
-        return $this->strategy;
-    }
-
-    /**
-     * @return Matcher
-     */
-
-    public function getMatcher()
-    {
-        return $this->matcher;
-    }
-
-    /**
-     * Verify if a Route have already been blocked.
-     *
-     * @return boolean
-     */
-
-    public function getBlock()
-    {
-        return $this->blocked;
-    }
-
-    /**
-     * Blocking a route indicate that that route have been selected and
-     * parsed, now it will be given to the matcher.
-     *
-     * @param bool $blocked
-     * @return self
-     */
-
-    public function setBlock($blocked)
-    {
-        $this->blocked = $blocked;
-        return $this;
-    }
-
-    /**
-     * @param string $method
-     * @return Route
-     */
-
-    public function setMethod($method)
-    {
-        $this->forget();
-        $this->method = $method;
-        return $this->reset();
-    }
-
-    /**
-     * @param string $pattern
-     * @return Route
-     */
-
-    public function setPattern($pattern)
-    {
-        $this->forget();
-        $this->pattern = $pattern;
-        return $this->reset();
-    }
-
-    /**
-     * @param string $pattern
-     * @return self
-     */
-
-    public function setPatternWithoutReset($pattern)
-    {
-        $this->pattern = $pattern;
-        return $this;
-    }
-
-    /**
-     * @param string $action
-     * @return self
-     */
-
-    public function setAction($action)
-    {
-        $this->action = $action;
-        return $this;
-    }
-
-    /**
-     * @param string $namespace
-     * @return self
-     */
-
-    public function setNamespace($namespace)
-    {
-        $this->namespace = $namespace;
-        return $this;
-    }
-
-    /**
-     * @param string[] $params
-     * @return self
-     */
-
-    public function setParams(array $params)
-    {
-        $this->params = $params;
-        return $this;
-    }
-
-    /**
-     * @param string $key
-     * @param string $value
-     *
-     * @return self
-     */
-
-    public function setParam($key, $value)
-    {
-        $this->params[$key] = $value;
-        return $this;
-    }
-
-    /**
-     * @param mixed[] $defaults
-     * @return self
-     */
-
-    public function setDefaults(array $defaults)
-    {
-        $this->defaults = $defaults;
-        return $this;
-    }
-
-    /**
-     * @param string $key
-     * @param mixed $value
-     *
-     * @return self
-     */
-
-    public function setDefault($key, $value)
-    {
-        $this->defaults[$key] = $value;
-        return $this;
-    }
-
-    /**
-     * @param mixed[] $metadata
-     * @return self
-     */
-
-    public function setMetadataArray(array $metadata)
-    {
-        $this->metadata = $metadata;
-        return $this;
-    }
-
-    /**
-     * @param string $key
-     * @param mixed $value
-     *
-     * @return $this
-     */
-
-    public function setMetadata($key, $value)
-    {
-        $this->metadata[$key] = $value;
-        return $this;
-    }
-
-    /**
-     * @param null|string|StrategyInterface $strategy
-     * @return self
-     */
-
-    public function setStrategy($strategy)
-    {
-        $this->strategy = $strategy;
-        return $this;
-    }
-
-    /**
-     * @param Matcher $matcher
-     * @return self
-     */
-
-    public function setMatcher(Matcher $matcher)
-    {
-        $this->matcher = $matcher;
-        return $this;
-    }
-
-    /**
-     * Set a constraint to a token in the route pattern.
-     *
-     * @param string $token
-     * @param string $regex
-     *
-     * @return self
-     */
-
-    public function setConstraint($token, $regex)
-    {
-        $initPos = strpos($this->pattern, "{" . $token);
-
-        if ($initPos !== false) {
-            $endPos = strpos($this->pattern, "}", $initPos);
-            $newPattern = substr_replace($this->pattern, "{" . "$token:$regex" . "}", $initPos, $endPos - $initPos + 1);
-            $wildcards = $this->collector->getParser()->getWildcardTokens();
-            $newPattern = str_replace(array_keys($wildcards), $wildcards, $newPattern);
-            $this->setPatternWithoutReset($newPattern);
-        }
-
-        return $this;
-    }
-
-    /**
-     * @param string $key
-     * @return bool
-     */
-
-    public function hasParam($key)
-    {
-        return isset($this->params[$key]);
-    }
-
-    /**
-     * @param string $key
-     * @return bool
-     */
-
-    public function hasDefault($key)
-    {
-        return isset($this->defaults[$key]);
-    }
-
-    /**
-     * @param string $key
-     * @return bool
-     */
-
-    public function hasMetadata($key)
-    {
-        return isset($this->metadata[$key]);
-    }
+	/**
+	 * @var callable
+	 */
+
+	protected $action;
+
+	/**
+	 * @var string
+	 */
+
+	protected $namespace = "";
+
+	/**
+	 * @var string[]
+	 */
+
+	protected $params = [];
+
+	/**
+	 * Defaults are parameters set by the user, and don't
+	 * appear on the pattern.
+	 *
+	 * @var array
+	 */
+
+	protected $defaults = [];
+
+	/**
+	 * Metadata can be set to be used on filters, dispatch strategies
+	 * or anywhere the route object is used.
+	 *
+	 * @var array
+	 */
+
+	protected $metadata = [];
+
+	/**
+	 * @var string|StrategyInterface
+	 */
+
+	protected $strategy;
+
+	/**
+	 * Blocked routes are dynamic routes selected to pass by the matcher.
+	 *
+	 * @var boolean
+	 */
+
+	protected $blocked = false;
+
+	/**
+	 * The matcher that dispatched this route.
+	 *
+	 * @var Matcher $matcher
+	 */
+
+	protected $matcher;
+
+	/**
+	 * The function used to create controllers from name.
+	 *
+	 * @var callable
+	 */
+
+	protected $controllerCreationFunction;
+
+	/**
+	 * @param Collector $collector
+	 * @param string $method
+	 * @param string $pattern
+	 * @param callable $action
+	 */
+
+	public function __construct(Collector $collector, $method, $pattern, $action)
+	{
+		$this->collector = $collector;
+		$this->method    = $method;
+		$this->pattern   = $pattern;
+		$this->action    = $action;
+	}
+
+	/**
+	 * Clone this route and set it into the collector.
+	 *
+	 * @return Route
+	 */
+
+	public function reset()
+	{
+		return $this->collector->set($this->method, $this->pattern, $this->action)->nth(0)
+							   ->setStrategy($this->strategy)->setParams($this->params)
+							   ->setDefaults($this->defaults)->setMetadataArray($this->metadata);
+	}
+
+	/**
+	 * Remove this route from the collector.
+	 *
+	 * @return self
+	 */
+
+	public function forget()
+	{
+		$this->collector->forget($this->method, $this->pattern);
+		return $this;
+	}
+
+	/**
+	 * Execute the route action, if no strategy was provided the action
+	 * will be executed by the call_user_func PHP function.
+	 *
+	 * @param callable $container
+	 * @throws BadRouteException
+	 * @return mixed
+	 */
+
+	public function call(callable $container = null)
+	{
+		$this->action = $this->buildCallable($this->action, $container);
+
+		if ($this->strategy === null) {
+			return call_user_func_array($this->action, array_merge($this->defaults, $this->params));
+		}
+
+		if (!is_object($this->strategy)) {
+			if ($container === null) {
+				   $this->strategy = new $this->strategy;
+			} else $this->strategy = $container($this->strategy);
+		}
+
+		return $this->callWithStrategy();
+	}
+
+	/**
+	 * Seek for dynamic content in one callable. This allow to use parameters defined on pattern on callable
+	 * definition, eg. "get" "/{resource:string+}/{slug:slug+}" "{resource}::find".
+	 *
+	 * This will snakecase the resource parameter and deal with as a controller, then call the find method.
+	 * A request for "/articles/my-first-article" will execute find method of Articles controller with only
+	 * "my-first-article" as parameter.
+	 *
+	 * @param callable $callable
+	 * @param callable $container
+	 *
+	 * @return callable
+	 */
+
+	private function buildCallable($callable, $container = null)
+	{
+		if (is_string($callable) && strpos($callable, "::")) {
+			$callable = explode("::", $callable);
+		}
+
+		if (is_array($callable)) {
+			if (is_string($callable[0])) {
+				   $callable[0] = $this->parseCallableController($callable[0], $container);
+			}
+
+			$callable[1] = $this->parseCallablePlaceholders($callable[1]);
+		}
+
+		return $callable;
+	}
+
+	/**
+	 * Get the controller object.
+	 *
+	 * @param string $controller
+	 * @param callable $container
+	 *
+	 * @return Object
+	 */
+
+	private function parseCallableController($controller, $container)
+	{
+		$controller  = rtrim($this->namespace, "\\") . "\\" . $this->parseCallablePlaceholders($controller);
+
+		if ($container === null) {
+			   return new $controller;
+		} else return $container($controller);
+	}
+
+	/**
+	 * Parse and replace dynamic content on route action.
+	 *
+	 * @param string $fragment Part of callable
+	 * @return string
+	 */
+
+	private function parseCallablePlaceholders($fragment)
+	{
+		if (strpos($fragment, "{") !== false) {
+			foreach ($this->params as $placeholder => $value) {
+				if (strpos($fragment, "{" . $placeholder . "}") !== false) {
+					$fragment = str_replace("{" . $placeholder . "}", ucwords(str_replace("-", " ", $value)), $fragment);
+				}
+			}
+		}
+
+		return $fragment;
+	}
+
+	/**
+	 * Execute the route action with the given strategy.
+	 *
+	 * @throws BadRouteException
+	 * @return mixed
+	 */
+
+	private function callWithStrategy()
+	{
+		if ($this->strategy instanceof StrategyInterface) {
+			if ($this->strategy instanceof MatcherAwareInterface) {
+				$this->strategy->setMatcher($this->matcher);
+			}
+
+			return $this->strategy->call($this);
+		}
+
+		throw new BadRouteException(str_replace("%s", get_class($this->strategy), BadRouteException::BAD_STRATEGY));
+	}
+
+	/**
+	 * @return Collector
+	 */
+
+	public function getCollector()
+	{
+		return $this->collector;
+	}
+
+	/**
+	 * @return string
+	 */
+
+	public function getMethod()
+	{
+		return $this->method;
+	}
+
+	/**
+	 * @return string
+	 */
+
+	public function getPattern()
+	{
+		return $this->pattern;
+	}
+
+	/**
+	 * @return string[]
+	 */
+
+	public function getSegments()
+	{
+		return explode("/", $this->pattern);
+	}
+
+	/**
+	 * @return callable
+	 */
+
+	public function getAction()
+	{
+		return $this->action;
+	}
+
+	/**
+	 * @return string
+	 */
+
+	public function getNamespace()
+	{
+		return $this->namespace;
+	}
+
+	/**
+	 * @return string[]
+	 */
+
+	public function getParams()
+	{
+		return $this->params;
+	}
+
+	/**
+	 * @param string $key
+	 * @return string
+	 */
+
+	public function getParam($key)
+	{
+		return $this->params[$key];
+	}
+
+	/**
+	 * Return defaults and params merged in one array.
+	 *
+	 * @return array
+	 */
+
+	public function getMergedParams()
+	{
+		return array_merge($this->defaults, $this->params);
+	}
+
+	/**
+	 * @return array
+	 */
+
+	public function getDefaults()
+	{
+		return $this->defaults;
+	}
+
+	/**
+	 * @param string $key
+	 * @return mixed
+	 */
+
+	public function getDefault($key)
+	{
+		return $this->defaults[$key];
+	}
+
+	/**
+	 * @return array
+	 */
+
+	public function getMetadataArray()
+	{
+		return $this->metadata;
+	}
+
+	/**
+	 * @param string $key
+	 * @return mixed
+	 */
+
+	public function getMetadata($key)
+	{
+		return $this->metadata[$key];
+	}
+
+	/**
+	 * @return string|null
+	 */
+
+	public function getStrategy()
+	{
+		if ($this->strategy instanceof StrategyInterface) {
+			return get_class($this->strategy);
+		}
+
+		return $this->strategy;
+	}
+
+	/**
+	 * @return StrategyInterface|string
+	 */
+
+	public function getRawStrategy()
+	{
+		return $this->strategy;
+	}
+
+	/**
+	 * @return Matcher
+	 */
+
+	public function getMatcher()
+	{
+		return $this->matcher;
+	}
+
+	/**
+	 * Verify if a Route have already been blocked.
+	 *
+	 * @return boolean
+	 */
+
+	public function getBlock()
+	{
+		return $this->blocked;
+	}
+
+	/**
+	 * Blocking a route indicate that that route have been selected and
+	 * parsed, now it will be given to the matcher.
+	 *
+	 * @param bool $blocked
+	 * @return self
+	 */
+
+	public function setBlock($blocked)
+	{
+		$this->blocked = $blocked;
+		return $this;
+	}
+
+	/**
+	 * @param string $method
+	 * @return Route
+	 */
+
+	public function setMethod($method)
+	{
+		$this->forget();
+		$this->method = $method;
+		return $this->reset();
+	}
+
+	/**
+	 * @param string $pattern
+	 * @return Route
+	 */
+
+	public function setPattern($pattern)
+	{
+		$this->forget();
+		$this->pattern = $pattern;
+		return $this->reset();
+	}
+
+	/**
+	 * @param string $pattern
+	 * @return self
+	 */
+
+	public function setPatternWithoutReset($pattern)
+	{
+		$this->pattern = $pattern;
+		return $this;
+	}
+
+	/**
+	 * @param string $action
+	 * @return self
+	 */
+
+	public function setAction($action)
+	{
+		$this->action = $action;
+		return $this;
+	}
+
+	/**
+	 * @param string $namespace
+	 * @return self
+	 */
+
+	public function setNamespace($namespace)
+	{
+		$this->namespace = $namespace;
+		return $this;
+	}
+
+	/**
+	 * @param string[] $params
+	 * @return self
+	 */
+
+	public function setParams(array $params)
+	{
+		$this->params = $params;
+		return $this;
+	}
+
+	/**
+	 * @param string $key
+	 * @param string $value
+	 *
+	 * @return self
+	 */
+
+	public function setParam($key, $value)
+	{
+		$this->params[$key] = $value;
+		return $this;
+	}
+
+	/**
+	 * @param mixed[] $defaults
+	 * @return self
+	 */
+
+	public function setDefaults(array $defaults)
+	{
+		$this->defaults = $defaults;
+		return $this;
+	}
+
+	/**
+	 * @param string $key
+	 * @param mixed $value
+	 *
+	 * @return self
+	 */
+
+	public function setDefault($key, $value)
+	{
+		$this->defaults[$key] = $value;
+		return $this;
+	}
+
+	/**
+	 * @param mixed[] $metadata
+	 * @return self
+	 */
+
+	public function setMetadataArray(array $metadata)
+	{
+		$this->metadata = $metadata;
+		return $this;
+	}
+
+	/**
+	 * @param string $key
+	 * @param mixed $value
+	 *
+	 * @return $this
+	 */
+
+	public function setMetadata($key, $value)
+	{
+		$this->metadata[$key] = $value;
+		return $this;
+	}
+
+	/**
+	 * @param null|string|StrategyInterface $strategy
+	 * @return self
+	 */
+
+	public function setStrategy($strategy)
+	{
+		$this->strategy = $strategy;
+		return $this;
+	}
+
+	/**
+	 * @param Matcher $matcher
+	 * @return self
+	 */
+
+	public function setMatcher(Matcher $matcher)
+	{
+		$this->matcher = $matcher;
+		return $this;
+	}
+
+	/**
+	 * Set a constraint to a token in the route pattern.
+	 *
+	 * @param string $token
+	 * @param string $regex
+	 *
+	 * @return self
+	 */
+
+	public function setConstraint($token, $regex)
+	{
+		$initPos = strpos($this->pattern, "{" . $token);
+
+		if ($initPos !== false) {
+			$endPos = strpos($this->pattern, "}", $initPos);
+			$newPattern = substr_replace($this->pattern, "{" . "$token:$regex" . "}", $initPos, $endPos - $initPos + 1);
+			$wildcards = $this->collector->getParser()->getWildcardTokens();
+			$newPattern = str_replace(array_keys($wildcards), $wildcards, $newPattern);
+			$this->setPatternWithoutReset($newPattern);
+		}
+
+		return $this;
+	}
+
+	/**
+	 * @param string $key
+	 * @return bool
+	 */
+
+	public function hasParam($key)
+	{
+		return isset($this->params[$key]);
+	}
+
+	/**
+	 * @param string $key
+	 * @return bool
+	 */
+
+	public function hasDefault($key)
+	{
+		return isset($this->defaults[$key]);
+	}
+
+	/**
+	 * @param string $key
+	 * @return bool
+	 */
+
+	public function hasMetadata($key)
+	{
+		return isset($this->metadata[$key]);
+	}
 
 }