cakephp2-php8/libs/dispatcher.php

<?PHP
//////////////////////////////////////////////////////////////////////////
// + $Id$
// +------------------------------------------------------------------+ //
// + Cake <https://developers.nextco.com/cake/>                       + //
// + Copyright: (c) 2005, Cake Authors/Developers                     + //
// + Author(s): Michal Tatarynowicz aka Pies <tatarynowicz@gmail.com> + //
// +            Larry E. Masters aka PhpNut <nut@phpnut.com>          + //
// +            Kamil Dzielinski aka Brego <brego.dk@gmail.com>       + //
// +------------------------------------------------------------------+ //
// + Licensed under The MIT License                                   + //
// + Redistributions of files must retain the above copyright notice. + //
// + See: http://www.opensource.org/licenses/mit-license.php          + //
//////////////////////////////////////////////////////////////////////////

/**
  * Purpose: Dispatcher
  * Dispatches the request, creating aproppriate models and controllers.
  * 
  * @filesource 
  * @author Cake Authors/Developers
  * @copyright Copyright (c) 2005, Cake Authors/Developers
  * @link https://developers.nextco.com/cake/wiki/Authors Authors/Developers
  * @package cake
  * @subpackage cake.libs
  * @since Cake v 0.2.9
  * @version $Revision$
  * @modifiedby $LastChangedBy$
  * @lastmodified $Date$
  * @license http://www.opensource.org/licenses/mit-license.php The MIT License
  */

/**
 * Description:
 * Dispatches the request, creating appropriate models and controllers.
 */

uses('error_messages', 'object', 'router', 'controller');

/**
  * Dispatches the request, creating appropriate models and controllers.
  *
  *
  * @package cake
  * @subpackage cake.libs
  * @since Cake v 0.2.9
  *
  */
class Dispatcher extends Object {
/**
  * Base URL
  *
  * @var unknown_type
  */
	var $base = false;
/**
  * Enter description here...
  *
  * @var array
  */
	var $passed_args = array();

/**
  * Constructor.
  *
  */
	function __construct () {
		$this->base = $this->baseUrl();
		parent::__construct();
	}

/**
  * Enter description here...
  *
  * @param string $url
  * @return unknown
  */
	function dispatch ($url) {
		global $_POST, $_GET, $_FILES, $_SESSION;

		/* @var $params array */
		$params = $this->parseParams($url);

		// die if no controller set
		if (empty($params['controller']))
			$this->errorNoController($url);

		$ctrl_name = Inflector::camelize($params['controller']);
		$ctrl_class = $ctrl_name.'Controller';

		/**
		 * Find out if the specified controller exists, and die if not.
		 */
		if (!loadController($ctrl_name) || !class_exists($ctrl_class))
			$this->errorUnknownController($url, $ctrl_name);

		$ctrl_methods = get_class_methods($ctrl_class);
		$ctrl_vars = get_class_vars($ctrl_class);

		/**
		 * If _no_action_is set, check if the default action, index() exists. If it doesn't, die.
		 */
		if (empty($params['action']))
		{
			if (in_array('index', $ctrl_methods))
			{
				$params['action'] = 'index';
			}
			else 
			{
				$this->errorNoAction($url);
			}
		}
		
		/**
		 * Check if the specified action really exists. 
		 */
		if (!in_array($params['action'], $ctrl_methods))
		{
			$this->errorUnknownAction($url, $ctrl_class, $params['action']);
		}

		$controller = new $ctrl_class ($params); 
		$controller->base = $this->base; 
		$controller->action = $params['action'];
		$controller->data = empty($params['data'])? null: $params['data'];
		$controller->passed_args = empty($params['pass'])? null: $params['pass'];
		
		// EXECUTE THE REQUESTED ACTION
		call_user_func_array(array(&$controller, $params['action']), empty($params['pass'])? null: $params['pass']);

		if ($controller->autoRender)
			$controller->render();

		return $params;
	}

/**
  * Returns array of GET and POST parameters. GET parameters are taken from given URL.
  *
  * @param string $from_url
  * @return array Parameters found in POST and GET.
  */
	function parseParams ($from_url) {
		global $_POST, $_FILES;

		// load routes config
		$Route = new Router();
		require CONFIGS.'routes.php';
		$params = $Route->parse ($from_url);

		// add submitted form data
		$params['form'] = $_POST;
		if (isset($_POST['data']))
			$params['data'] = $_POST['data'];

		foreach ($_FILES as $name => $data)
			$params['form'][$name] = $data;

		return $params;
	}

/**
  * Returns a base URL.
  *
  * @return string
  */
	function baseUrl () {
		global $_SERVER;

		//non mod_rewrite use:
		if (defined('BASE_URL')) return BASE_URL;

		$doc_root = $_SERVER['DOCUMENT_ROOT'];
		$script_name = $_SERVER['PHP_SELF'];

		// if document root ends with 'public', it's probably correctly set
		$r = null;
		if (ereg('/^.*/public(\/)?$/', $doc_root))
			return preg_match('/^(.*)\/index\.php$/', $script_name, $r)? $r[1]: false;
		else
			// document root is probably not set to Cake 'public' dir
			return preg_match('/^(.*)\/public\/index\.php$/', $script_name, $r)? $r[1]: false;
	}

/**
  * Displays an error page (e.g. 404 Not found).
  *
  * @param int $code Error code (e.g. 404)
  * @param string $name Name of the error message (e.g. Not found)
  * @param string $message
  */
	function error ($code, $name, $message) {
		$controller = new Controller ($this);
		$controller->base = $this->base;
		$controller->error($code, $name, $message);
	}

/**
  * Convenience method to display a 404 page.
  *
  * @param unknown_type $url
  * @param unknown_type $message
  */
	function error404 ($url, $message) {
		$this->error('404', 'Not found', sprintf(ERROR_404, $url, $message));
	}

/**
  * If DEBUG is set, this displays a 404 error with the message that no controller is set. If DEBUG is not set, nothing happens.
  *
  * @param string $url
  */
	function errorNoController ($url) {
		DEBUG?
			trigger_error (ERROR_NO_CONTROLLER_SET, E_USER_ERROR): 
			$this->error404($url, "no controller set");
		exit;
	}

/**
  * If DEBUG is set, this displays a 404 error with the message that the asked-for controller does not exist. If DEBUG is not set, nothing happens.
  *
  * @param string $url
  * @param string $controller_class
  */
	function errorUnknownController ($url, $controller_class) {
		DEBUG? 
			trigger_error (sprintf(ERROR_UNKNOWN_CONTROLLER, $controller_class), E_USER_ERROR): 
			$this->error404($url, "missing controller \"{$controller_class}\"");
		exit;
	}

/**
  * If DEBUG is set, this displays a 404 error with the message that no action is set. If DEBUG is not set, nothing happens.
  *
  * @param string $url
  */
	function errorNoAction ($url) {
		DEBUG? 
			trigger_error (ERROR_NO_ACTION_SET, E_USER_ERROR):
			$this->error404(sprintf(ERROR_404, $url, "no action set"));
		exit;
	}

/**
  * If DEBUG is set, this displays a 404 error with the message that no such action exists. If DEBUG is not set, nothing happens.
  *
  * @param string $url
  * @param string $controller_class
  * @param string $action
  */
	function errorUnknownAction ($url,$controller_class, $action) {
		DEBUG? 
			trigger_error (sprintf(ERROR_NO_ACTION, $action, $controller_class), E_USER_ERROR): 
			$this->error404($url, "missing controller \"{$controller_class}\"");
		exit;
	}
}

?>