<?php
/* SVN FILE: $Id$ */

/**
 * Dispatcher takes the URL information, parses it for paramters and
 * tells the involved controllers what to do.
 *
 * This is the heart of Cake's operation.
 *
 * PHP versions 4 and 5
 *
 * CakePHP :  Rapid Development Framework <http://www.cakephp.org/>
 * Copyright (c) 2006, Cake Software Foundation, Inc.
 *                     1785 E. Sahara Avenue, Suite 490-204
 *                     Las Vegas, Nevada 89104
 *
 * Licensed under The MIT License
 * Redistributions of files must retain the above copyright notice.
 *
 * @filesource
 * @copyright    Copyright (c) 2006, Cake Software Foundation, Inc.
 * @link         http://www.cakefoundation.org/projects/info/cakephp CakePHP Project
 * @package      cake
 * @subpackage   cake.cake
 * @since        CakePHP v 0.2.9
 * @version      $Revision$
 * @modifiedby   $LastChangedBy$
 * @lastmodified $Date$
 * @license      http://www.opensource.org/licenses/mit-license.php The MIT License
 */

/**
 * List of helpers to include
 */
uses('router', DS.'controller'.DS.'controller');

/**
 * Dispatcher translates URLs to controller-action-paramter triads.
 *
 * Dispatches the request, creating appropriate models and controllers.
 *
 * @package    cake
 * @subpackage   cake.cake
 * @since      CakePHP v 0.2.9
 */
class Dispatcher extends Object
{
/**
 * Base URL
 * @var string
 */
    var $base = false;

/**
 * @var string
 */
    var $admin = false;

/**
 * @var string
 */
    var $webservices = null;

/**
 * @var string
 */
    var $plugin = null;

/**
 * Constructor.
 */
    function __construct()
    {
      parent::__construct();
    }

/**
 * Dispatches and invokes given URL, handing over control to the involved controllers, and then renders the results (if autoRender is set).
 *
 * If no controller of given name can be found, invoke() shows error messages in
 * the form of Missing Controllers information. It does the same with Actions (methods of Controllers are called
 * Actions).
 *
 * @param string $url    URL information to work on.
 * @return boolean        Success
 */
    function dispatch($url, $additionalParams=array())
    {
      $params = array_merge($this->parseParams($url), $additionalParams);
      $missingController = false;
      $missingAction     = false;
      $missingView        = false;
      $privateAction     = false;
      $this->base = $this->baseUrl();
      if (empty($params['controller']))
      {
         $missingController = true;
      }
      else
      {
         $ctrlName  = Inflector::camelize($params['controller']);
         $ctrlClass = $ctrlName.'Controller';

         if(!class_exists($ctrlClass))
         {
             if (!loadController($ctrlName))
             {
                 $plugin = $ctrlName;
                 $pluginName  = Inflector::camelize($params['action']);
                 $pluginClass = $pluginName.'Controller';

                 if (!loadPluginController(Inflector::underscore($ctrlName), $pluginName))
                 {
                     if(preg_match('/([\\.]+)/', $ctrlName))
                     {
                         return $this->cakeError('error404',array(array('url' => strtolower($ctrlName),
                                                 'message' => 'Was not found on this server')));
                         exit();
                     }
                     else
                     {
                         $missingController = true;
                     }
                 }
                 else
                 {
                     $ctrlClass = $pluginClass;
                     $oldAction = $params['action'];
                     $params = $this->_restructureParams($params);
                     $plugin = Inflector::underscore($ctrlName);
                     $this->plugin = $plugin;
                     loadPluginModels($plugin);
                     $this->base = $this->base.'/'.Inflector::underscore($ctrlName);
                     if(empty($params['controller']) || !class_exists($pluginClass))
                     {
                         $params['controller'] = Inflector::underscore($ctrlName);
                         $ctrlClass = $ctrlName.'Controller';
                         if (!is_null($params['action']))
                         {
                             array_unshift($params['pass'], $params['action']);
                         }
                         $params['action'] = $oldAction;
                     }
                 }
             }
         }
      }

      if(defined('CAKE_ADMIN'))
      {
          if(isset($params[CAKE_ADMIN]))
          {
              $this->admin = '/'.CAKE_ADMIN ;
              $url = preg_replace('/'.CAKE_ADMIN.'\//', '', $url);
              if (empty($params['action']))
              {
                  $params['action'] = CAKE_ADMIN.'_'.'index';
              }
              else
              {
                  $params['action'] = CAKE_ADMIN.'_'.$params['action'];
              }
          }
      }


      if ($missingController)
      {
          return $this->cakeError('missingController',array(array('className' => Inflector::camelize($params['controller']."Controller"),
                                    'webroot' => $this->webroot)));
      }
      else
      {
         $controller =& new $ctrlClass($this);
      }

      $classMethods = get_class_methods($controller);
      $classVars = get_object_vars($controller);

      if (empty($params['action']))
      {
          $params['action'] = 'index';
      }

      if((in_array($params['action'], $classMethods) || in_array(strtolower($params['action']), $classMethods)) && strpos($params['action'], '_', 0) === 0)
      {
          $privateAction = true;
      }

      if(!in_array($params['action'], $classMethods) && !in_array(strtolower($params['action']), $classMethods))
      {
          $missingAction = true;
      }

      if(in_array('return', array_keys($params)) && $params['return'] == 1)
      {
          $controller->autoRender = false;
      }

      $controller->base        = $this->base;
      $controller->here        = $this->base.'/'.$url;
      $controller->webroot     = $this->webroot;
      $controller->params      = $params;
      $controller->action      = $params['action'];
      $controller->data        = empty($params['data'])? null: $params['data'];
      $controller->passed_args = empty($params['pass'])? null: $params['pass'];
      $controller->autoLayout  = empty($params['bare'])?$controller->autoLayout:!$params['bare'];
      $controller->webservices = $params['webservices'];
      $controller->plugin      = $this->plugin;

      if(!is_null($controller->webservices))
      {
          array_push($controller->components, $controller->webservices);
          array_push($controller->helpers, $controller->webservices);
          $component =& new Component($controller);
      }

      if((in_array('scaffold', array_keys($classVars))) && ($missingAction === true))
      {
          uses(DS.'controller'.DS.'scaffold');
          return new Scaffold($controller, $params);
      }

      $controller->constructClasses();

      if ($missingAction)
      {
          return $this->cakeError('missingAction',
                      array(array('className' => Inflector::camelize($params['controller']."Controller"),
                                  'action' => $params['action'],
                                  'webroot' => $this->webroot)));
      }

      if ($privateAction)
      {
          return $this->cakeError('privateAction',
                      array(array('className' => Inflector::camelize($params['controller']."Controller"),
                                  'action' => $params['action'],
                                  'webroot' => $this->webroot)));
      }

      return $this->_invoke($controller, $params);
    }

/**
 * Invokes given controller's render action if autoRender option is set. Otherwise the contents of the operation are returned as a string.
 *
 * @param object $controller
 * @param array $params
 * @return string
 */
    function _invoke (&$controller, $params)
    {
        if (!empty($controller->beforeFilter))
        {
            if(is_array($controller->beforeFilter))
            {
                foreach($controller->beforeFilter as $filter)
                {
                    if(is_callable(array($controller,$filter)) && $filter != 'beforeFilter')
                    {
                        $controller->$filter();
                    }
                }
            }
            else
            {
                if(is_callable(array($controller, $controller->beforeFilter)) && $controller->beforeFilter != 'beforeFilter')
                {
                    $controller->{$controller->beforeFilter}();
                }
            }
        }
        $controller->beforeFilter();

        foreach($controller->components as $c)
        {
            if (isset($controller->{$c}) && is_object($controller->{$c}) && is_callable(array($controller->{$c}, 'startup')))
            {
                $controller->{$c}->startup($controller);
            }
        }

        $output = call_user_func_array(array(&$controller, $params['action']), empty($params['pass'])? null: $params['pass']);
        if ($controller->autoRender)
        {
            $output = $controller->render();
        }
        $controller->output =& $output;
        $controller->afterFilter();
        return $controller->output;
    }

/**
 * Returns array of GET and POST parameters. GET parameters are taken from given URL.
 *
 * @param string $from_url    URL to mine for parameter information.
 * @return array Parameters found in POST and GET.
 */
    function parseParams($from_url)
    {
// load routes config
        $Route = new Router();
        include CONFIGS.'routes.php';
        $params = $Route->parse ($from_url);

        if (ini_get('magic_quotes_gpc') == 1)
        {
            if(!empty($_POST))
            {
                $params['form'] = stripslashes_deep($_POST);
            }
        }
        else
        {
            $params['form'] = $_POST;
        }

        if (isset($params['form']['data']))
        {
                $params['data'] = $params['form']['data'];
        }

        if (isset($_GET))
        {
            if (ini_get('magic_quotes_gpc') == 1)
            {
                $params['url'] = stripslashes_deep($_GET);
            }
            else
            {
                $params['url'] = $_GET;
            }
        }

        foreach ($_FILES as $name => $data)
        {
            $params['form'][$name] = $data;
        }
        $params['bare'] = empty($params['ajax'])? (empty($params['bare'])? 0: 1): 1;

        $params['webservices'] = empty($params['webservices']) ? null : $params['webservices'];

        return $params;
    }

/**
 * Returns a base URL.
 *
 * @return string    Base URL
 */
    function baseUrl()
    {
        $htaccess = null;
        $base = $this->admin;
        $this->webroot = '';
        if (defined('BASE_URL'))
        {
            $base = BASE_URL.$this->admin;
        }
        $docRoot = env('DOCUMENT_ROOT');
        $scriptName = env('PHP_SELF');
        $r = null;

        if (preg_match('/'.APP_DIR.'\\'.DS.WEBROOT_DIR.'/', $docRoot))
        {
            $this->webroot = '/';
            if (preg_match('/^(.*)\/index\.php$/', $scriptName, $r))
            {
                if(!empty($r[1]))
                {
                    return  $base.$r[1];
                }
            }
        }
        else
        {
            if (defined('BASE_URL'))
            {
                $webroot = setUri();
                $htaccess =  preg_replace('/(?:'.APP_DIR.'(.*)|index\\.php(.*))/i', '', $webroot).APP_DIR.'/'.WEBROOT_DIR.'/';
            }
            if (preg_match('/^(.*)\\/'.APP_DIR.'\\/'.WEBROOT_DIR.'\\/index\\.php$/', $scriptName, $regs))
            {
                if(APP_DIR === 'app')
                {
                    $appDir = null;
                }
                else
                {
                    $appDir = '/'.APP_DIR;
                }
                !empty($htaccess)? $this->webroot = $htaccess : $this->webroot = $regs[1].$appDir.'/';
                return  $base.$regs[1].$appDir;
            }
            elseif (preg_match('/^(.*)\\/'.WEBROOT_DIR.'([^\/i]*)|index\\\.php$/', $scriptName, $regs))
            {
                !empty($htaccess)? $this->webroot = $htaccess : $this->webroot = $regs[0].'/';
                return  $base.$regs[0];
            }
            else
            {
                !empty($htaccess)? $this->webroot = $htaccess : $this->webroot = '/';
                return $base;
            }
        }
        return $base;
    }

    function _restructureParams($params)
    {
        $params['controller'] = $params['action'];
        if(isset($params['pass'][0]))
        {
            $params['action'] = $params['pass'][0];
            array_shift($params['pass']);
        }
        else
        {
            $params['action'] = null;
        }
        return $params;
    }
}
?>