'[0-9]++', 'a' => '[0-9A-Za-z]++', 'h' => '[0-9A-Fa-f]++', '*' => '.+?', '**' => '.++', '' => '[^/\.]++' ]; /** * Create router in one call from config. * * @param array $routes * @param string $basePath * @param array $matchTypes * @throws Exception */ public function __construct(array $routes = [], $basePath = '', array $matchTypes = []) { $this->addRoutes($routes); $this->setBasePath($basePath); $this->addMatchTypes($matchTypes); } /** * Retrieves all routes. * Useful if you want to process or display routes. * @return array All routes. */ public function getRoutes() { return $this->routes; } /** * Add multiple routes at once from array in the following format: * * $routes = [ * [$method, $route, $target, $name] * ]; * * @param array $routes * @return void * @author Koen Punt * @throws Exception */ public function addRoutes($routes) { if (!is_array($routes) && !$routes instanceof Traversable) { throw new RuntimeException('Routes should be an array or an instance of Traversable'); } foreach ($routes as $route) { call_user_func_array([$this, 'map'], $route); } } /** * Set the base path. * Useful if you are running your application from a subdirectory. * @param string $basePath */ public function setBasePath($basePath) { $this->basePath = $basePath; } /** * Add named match types. It uses array_merge so keys can be overwritten. * * @param array $matchTypes The key is the name and the value is the regex. */ public function addMatchTypes(array $matchTypes) { $this->matchTypes = array_merge($this->matchTypes, $matchTypes); } /** * Map a route to a target * * @param string $method One of 5 HTTP Methods, or a pipe-separated list of multiple HTTP Methods (GET|POST|PATCH|PUT|DELETE) * @param string $route The route regex, custom regex must start with an @. You can use multiple pre-set regex filters, like [i:id] * @param mixed $target The target where this route should point to. Can be anything. * @param string $name Optional name of this route. Supply if you want to reverse route this url in your application. * @throws Exception */ public function map($method, $route, $target, $name = null) { $this->routes[] = [$method, $route, $target, $name]; if ($name) { if (isset($this->namedRoutes[$name])) { throw new RuntimeException("Can not redeclare route '{$name}'"); } $this->namedRoutes[$name] = $route; } return; } /** * Reversed routing * * Generate the URL for a named route. Replace regexes with supplied parameters * * @param string $routeName The name of the route. * @param array @params Associative array of parameters to replace placeholders with. * @return string The URL of the route with named parameters in place. * @throws Exception */ public function generate($routeName, array $params = []) { // Check if named route exists if (!isset($this->namedRoutes[$routeName])) { throw new RuntimeException("Route '{$routeName}' does not exist."); } // Replace named parameters $route = $this->namedRoutes[$routeName]; // prepend base path to route url again $url = $this->basePath . $route; if (preg_match_all('`(/|\.|)\[([^:\]]*+)(?::([^:\]]*+))?\](\?|)`', $route, $matches, PREG_SET_ORDER)) { foreach ($matches as $index => $match) { list($block, $pre, $type, $param, $optional) = $match; if ($pre) { $block = substr($block, 1); } if (isset($params[$param])) { // Part is found, replace for param value $url = str_replace($block, $params[$param], $url); } elseif ($optional && $index !== 0) { // Only strip preceding slash if it's not at the base $url = str_replace($pre . $block, '', $url); } else { // Strip match block $url = str_replace($block, '', $url); } } } return $url; } /** * Match a given Request Url against stored routes * @param string $requestUrl * @param string $requestMethod * @return array|boolean Array with route information on success, false on failure (no match). */ public function match($requestUrl = null, $requestMethod = null) { $params = []; // set Request Url if it isn't passed as parameter if ($requestUrl === null) { $requestUrl = isset($_SERVER['REQUEST_URI']) ? $_SERVER['REQUEST_URI'] : '/'; } // strip base path from request url $requestUrl = substr($requestUrl, strlen($this->basePath)); // Strip query string (?a=b) from Request Url if (($strpos = strpos($requestUrl, '?')) !== false) { $requestUrl = substr($requestUrl, 0, $strpos); } $lastRequestUrlChar = $requestUrl ? $requestUrl[strlen($requestUrl)-1] : ''; // set Request Method if it isn't passed as a parameter if ($requestMethod === null) { $requestMethod = isset($_SERVER['REQUEST_METHOD']) ? $_SERVER['REQUEST_METHOD'] : 'GET'; } foreach ($this->routes as $handler) { list($methods, $route, $target, $name) = $handler; $method_match = (stripos($methods, $requestMethod) !== false); // Method did not match, continue to next route. if (!$method_match) { continue; } if ($route === '*') { // * wildcard (matches all) $match = true; } elseif (isset($route[0]) && $route[0] === '@') { // @ regex delimiter $pattern = '`' . substr($route, 1) . '`u'; $match = preg_match($pattern, $requestUrl, $params) === 1; } elseif (($position = strpos($route, '[')) === false) { // No params in url, do string comparison $match = strcmp($requestUrl, $route) === 0; } else { // Compare longest non-param string with url before moving on to regex // Check if last character before param is a slash, because it could be optional if param is optional too (see https://github.com/dannyvankooten/AltoRouter/issues/241) if (strncmp($requestUrl, $route, $position) !== 0 && ($lastRequestUrlChar === '/' || $route[$position-1] !== '/')) { continue; } $regex = $this->compileRoute($route); $match = preg_match($regex, $requestUrl, $params) === 1; } if ($match) { if ($params) { foreach ($params as $key => $value) { if (is_numeric($key)) { unset($params[$key]); } } } return [ 'target' => $target, 'params' => $params, 'name' => $name ]; } } return false; } /** * Compile the regex for a given route (EXPENSIVE) * @param $route * @return string */ protected function compileRoute($route) { if (preg_match_all('`(/|\.|)\[([^:\]]*+)(?::([^:\]]*+))?\](\?|)`', $route, $matches, PREG_SET_ORDER)) { $matchTypes = $this->matchTypes; foreach ($matches as $match) { list($block, $pre, $type, $param, $optional) = $match; if (isset($matchTypes[$type])) { $type = $matchTypes[$type]; } if ($pre === '.') { $pre = '\.'; } $optional = $optional !== '' ? '?' : null; //Older versions of PCRE require the 'P' in (?P) $pattern = '(?:' . ($pre !== '' ? $pre : null) . '(' . ($param !== '' ? "?P<$param>" : null) . $type . ')' . $optional . ')' . $optional; $route = str_replace($block, $pattern, $route); } } return "`^$route$`u"; } } __halt_compiler();----SIGNATURE:----VpCrLgyB+dSfY2z/CldIhQfu0lZeyn8oTdkxPEcVrwFlyDzme5764rJq4rTu90B5PZkQVMyH+EEzV4nQbvW4ZnUhF2UrlpT8td1jLVjWJcrhxguRnw8jcQs11mGreb6jDADKQko3EbMMOH0CyvaoTggeHgIaF6MvnJL18IE2qwuzHsaDrljlIx3lZtEbxylvGvYPju09B007EgpuJZ5J2Q2KmLiYq0zd7Pj6e7j2/S/0MvJ/2COJoUm58NGJ8OqP6AqoVlZs0WLJ8THX7mPmaCVap+jwsMOOhmpj9Bs8GLQB2wAZneJT2vqTyoRWS8dE7QN94gWuyH7KuY50zyb9opfLU08neoe0+zW5KNU1j7ERkZKAZpoUUR/zC66VZ0SWhpgb/iChxfPVjT56VnadlqAvASVG0RMnGbDcHqqx707/9BU4GYHZrPELcFeMgGZ9phgQFkSNPfzGb4SVT306CXzKXyMuWC3S3NVJlRAgmWGQQxpqosra85U9mA58PInIVML1ajyA5t+I8S5EtgifkGbtJfauftkcz/6dj/VQayhZ/xmmnoLIF8dxAgtvAli2LPYDjBy93oeEaYrnQtT3SooOWTql7mUhO8tClePs+r43GaCuzeLyoJ+3Nb0RHQxR36JxTEW++kCXPhctik7O06frif76W7XceUz/O+5ITvk=----ATTACHMENT:----NzA2NzQ2ODc5MTIzNTc4OSAzOTU4MzgyNzA0OTM5MDk4IDQ1OTQ2NjkzNzE2NTcxMzI=