/Kohana_v2.3.3/system/libraries/Router.php
PHP | 304 lines | 216 code | 36 blank | 52 comment | 13 complexity | 78638042098f4ee6ad626d1db250b19c MD5 | raw file
- <?php defined('SYSPATH') OR die('No direct access allowed.');
- /**
- * Router
- *
- * $Id: Router.php 4350 2009-05-14 18:58:18Z zombor $
- *
- * @package Core
- * @author Kohana Team
- * @copyright (c) 2007-2008 Kohana Team
- * @license http://kohanaphp.com/license.html
- */
- class Router_Core {
- protected static $routes;
- public static $current_uri = '';
- public static $query_string = '';
- public static $complete_uri = '';
- public static $routed_uri = '';
- public static $url_suffix = '';
- public static $segments;
- public static $rsegments;
- public static $controller;
- public static $controller_path;
- public static $method = 'index';
- public static $arguments = array();
- /**
- * Router setup routine. Automatically called during Kohana setup process.
- *
- * @return void
- */
- public static function setup()
- {
- if ( ! empty($_SERVER['QUERY_STRING']))
- {
- // Set the query string to the current query string
- Router::$query_string = '?'.trim($_SERVER['QUERY_STRING'], '&/');
- }
- if (Router::$routes === NULL)
- {
- // Load routes
- Router::$routes = Kohana::config('routes');
- }
- // Default route status
- $default_route = FALSE;
- if (Router::$current_uri === '')
- {
- // Make sure the default route is set
- if ( ! isset(Router::$routes['_default']))
- throw new Kohana_Exception('core.no_default_route');
- // Use the default route when no segments exist
- Router::$current_uri = Router::$routes['_default'];
- // Default route is in use
- $default_route = TRUE;
- }
- // Make sure the URL is not tainted with HTML characters
- Router::$current_uri = html::specialchars(Router::$current_uri, FALSE);
- // Remove all dot-paths from the URI, they are not valid
- Router::$current_uri = preg_replace('#\.[\s./]*/#', '', Router::$current_uri);
- // At this point segments, rsegments, and current URI are all the same
- Router::$segments = Router::$rsegments = Router::$current_uri = trim(Router::$current_uri, '/');
- // Set the complete URI
- Router::$complete_uri = Router::$current_uri.Router::$query_string;
- // Explode the segments by slashes
- Router::$segments = ($default_route === TRUE OR Router::$segments === '') ? array() : explode('/', Router::$segments);
- if ($default_route === FALSE AND count(Router::$routes) > 1)
- {
- // Custom routing
- Router::$rsegments = Router::routed_uri(Router::$current_uri);
- }
- // The routed URI is now complete
- Router::$routed_uri = Router::$rsegments;
- // Routed segments will never be empty
- Router::$rsegments = explode('/', Router::$rsegments);
- // Prepare to find the controller
- $controller_path = '';
- $method_segment = NULL;
- // Paths to search
- $paths = Kohana::include_paths();
- foreach (Router::$rsegments as $key => $segment)
- {
- // Add the segment to the search path
- $controller_path .= $segment;
- $found = FALSE;
- foreach ($paths as $dir)
- {
- // Search within controllers only
- $dir .= 'controllers/';
- if (is_dir($dir.$controller_path) OR is_file($dir.$controller_path.EXT))
- {
- // Valid path
- $found = TRUE;
- // The controller must be a file that exists with the search path
- if ($c = str_replace('\\', '/', realpath($dir.$controller_path.EXT))
- AND is_file($c) AND strpos($c, $dir) === 0)
- {
- // Set controller name
- Router::$controller = $segment;
- // Change controller path
- Router::$controller_path = $c;
- // Set the method segment
- $method_segment = $key + 1;
- // Stop searching
- break;
- }
- }
- }
- if ($found === FALSE)
- {
- // Maximum depth has been reached, stop searching
- break;
- }
- // Add another slash
- $controller_path .= '/';
- }
- if ($method_segment !== NULL AND isset(Router::$rsegments[$method_segment]))
- {
- // Set method
- Router::$method = Router::$rsegments[$method_segment];
- if (isset(Router::$rsegments[$method_segment + 1]))
- {
- // Set arguments
- Router::$arguments = array_slice(Router::$rsegments, $method_segment + 1);
- }
- }
- // Last chance to set routing before a 404 is triggered
- Event::run('system.post_routing');
- if (Router::$controller === NULL)
- {
- // No controller was found, so no page can be rendered
- Event::run('system.404');
- }
- }
- /**
- * Attempts to determine the current URI using CLI, GET, PATH_INFO, ORIG_PATH_INFO, or PHP_SELF.
- *
- * @return void
- */
- public static function find_uri()
- {
- if (PHP_SAPI === 'cli')
- {
- // Command line requires a bit of hacking
- if (isset($_SERVER['argv'][1]))
- {
- Router::$current_uri = $_SERVER['argv'][1];
- // Remove GET string from segments
- if (($query = strpos(Router::$current_uri, '?')) !== FALSE)
- {
- list (Router::$current_uri, $query) = explode('?', Router::$current_uri, 2);
- // Parse the query string into $_GET
- parse_str($query, $_GET);
- // Convert $_GET to UTF-8
- $_GET = utf8::clean($_GET);
- }
- }
- }
- elseif (isset($_GET['kohana_uri']))
- {
- // Use the URI defined in the query string
- Router::$current_uri = $_GET['kohana_uri'];
- // Remove the URI from $_GET
- unset($_GET['kohana_uri']);
- // Remove the URI from $_SERVER['QUERY_STRING']
- $_SERVER['QUERY_STRING'] = preg_replace('~\bkohana_uri\b[^&]*+&?~', '', $_SERVER['QUERY_STRING']);
- }
- elseif (isset($_SERVER['PATH_INFO']) AND $_SERVER['PATH_INFO'])
- {
- Router::$current_uri = $_SERVER['PATH_INFO'];
- }
- elseif (isset($_SERVER['ORIG_PATH_INFO']) AND $_SERVER['ORIG_PATH_INFO'])
- {
- Router::$current_uri = $_SERVER['ORIG_PATH_INFO'];
- }
- elseif (isset($_SERVER['PHP_SELF']) AND $_SERVER['PHP_SELF'])
- {
- Router::$current_uri = $_SERVER['PHP_SELF'];
- if (($strpos_fc = strpos(Router::$current_uri, KOHANA)) !== FALSE)
- {
- // Remove the front controller from the current uri
- Router::$current_uri = substr(Router::$current_uri, $strpos_fc + strlen(KOHANA));
- }
- }
- // Remove slashes from the start and end of the URI
- Router::$current_uri = trim(Router::$current_uri, '/');
- if (Router::$current_uri !== '')
- {
- if ($suffix = Kohana::config('core.url_suffix') AND strpos(Router::$current_uri, $suffix) !== FALSE)
- {
- // Remove the URL suffix
- Router::$current_uri = preg_replace('#'.preg_quote($suffix).'$#u', '', Router::$current_uri);
- // Set the URL suffix
- Router::$url_suffix = $suffix;
- }
- // Reduce multiple slashes into single slashes
- Router::$current_uri = preg_replace('#//+#', '/', Router::$current_uri);
- }
- }
- /**
- * Generates routed URI from given URI.
- *
- * @param string URI to convert
- * @return string Routed uri
- */
- public static function routed_uri($uri)
- {
- if (Router::$routes === NULL)
- {
- // Load routes
- Router::$routes = Kohana::config('routes');
- }
- // Prepare variables
- $routed_uri = $uri = trim($uri, '/');
- if (isset(Router::$routes[$uri]))
- {
- // Literal match, no need for regex
- $routed_uri = Router::$routes[$uri];
- }
- else
- {
- // Loop through the routes and see if anything matches
- foreach (Router::$routes as $key => $val)
- {
- if ($key === '_default') continue;
- // Trim slashes
- $key = trim($key, '/');
- $val = trim($val, '/');
- if (preg_match('#^'.$key.'$#u', $uri))
- {
- if (strpos($val, '$') !== FALSE)
- {
- // Use regex routing
- $routed_uri = preg_replace('#^'.$key.'$#u', $val, $uri);
- }
- else
- {
- // Standard routing
- $routed_uri = $val;
- }
- // A valid route has been found
- break;
- }
- }
- }
- if (isset(Router::$routes[$routed_uri]))
- {
- // Check for double routing (without regex)
- $routed_uri = Router::$routes[$routed_uri];
- }
- return trim($routed_uri, '/');
- }
- } // End Router