File indexing completed on 2024-12-29 05:27:32

 <?php
 /**
  * Zend Framework
  *
  * LICENSE
  *
  * This source file is subject to the new BSD license that is bundled
  * with this package in the file LICENSE.txt.
  * It is also available through the world-wide-web at this URL:
  * http://framework.zend.com/license/new-bsd
  * If you did not receive a copy of the license and are unable to
  * obtain it through the world-wide-web, please send an email
  * to license@zend.com so we can send you a copy immediately.
  *
  * @category   Zend
  * @package    Zend_Controller
  * @subpackage Router
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @version    $Id$
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  */
 
 /** Zend_Controller_Router_Route_Abstract */
 // require_once 'Zend/Controller/Router/Route/Abstract.php';
 
 /**
  * Module Route
  *
  * Default route for module functionality
  *
  * @package    Zend_Controller
  * @subpackage Router
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  * @see        http://manuals.rubyonrails.com/read/chapter/65
  */
 class Zend_Controller_Router_Route_Module extends Zend_Controller_Router_Route_Abstract
 {
 
     /**
      * Default values for the route (ie. module, controller, action, params)
      *
      * @var array
      */
     protected $_defaults;
 
     /**
      * Default values for the route (ie. module, controller, action, params)
      *
      * @var array
      */
     protected $_values = array();
 
     /**
      * @var boolean
      */
     protected $_moduleValid = false;
 
     /**
      * @var boolean
      */
     protected $_keysSet = false;
 
     /**#@+
      * Array keys to use for module, controller, and action. Should be taken out of request.
      *
      * @var string
      */
     protected $_moduleKey     = 'module';
     protected $_controllerKey = 'controller';
     protected $_actionKey     = 'action';
     /**#@-*/
 
     /**
      * @var Zend_Controller_Dispatcher_Interface
      */
     protected $_dispatcher;
 
     /**
      * @var Zend_Controller_Request_Abstract
      */
     protected $_request;
 
     /**
      * Get the version of the route
      *
      * @return int
      */
     public function getVersion()
     {
         return 1;
     }
 
     /**
      * Instantiates route based on passed Zend_Config structure
      *
      * @param Zend_Config $config
      * @return Zend_Controller_Router_Route_Module
      */
     public static function getInstance(Zend_Config $config)
     {
         $frontController = Zend_Controller_Front::getInstance();
 
         $defs       = ($config->defaults instanceof Zend_Config) ? $config->defaults->toArray() : array();
         $dispatcher = $frontController->getDispatcher();
         $request    = $frontController->getRequest();
 
         return new self($defs, $dispatcher, $request);
     }
 
     /**
      * Constructor
      *
      * @param array                                $defaults   Defaults for map variables with keys as variable names
      * @param Zend_Controller_Dispatcher_Interface $dispatcher Dispatcher object
      * @param Zend_Controller_Request_Abstract     $request    Request object
      */
     public function __construct(
         array $defaults = array(),
         Zend_Controller_Dispatcher_Interface $dispatcher = null,
         Zend_Controller_Request_Abstract $request = null
     )
     {
         $this->_defaults = $defaults;
 
         if (isset($request)) {
             $this->_request = $request;
         }
 
         if (isset($dispatcher)) {
             $this->_dispatcher = $dispatcher;
         }
     }
 
     /**
      * Set request keys based on values in request object
      *
      * @return void
      */
     protected function _setRequestKeys()
     {
         if (null !== $this->_request) {
             $this->_moduleKey     = $this->_request->getModuleKey();
             $this->_controllerKey = $this->_request->getControllerKey();
             $this->_actionKey     = $this->_request->getActionKey();
         }
 
         if (null !== $this->_dispatcher) {
             $this->_defaults += array(
                 $this->_controllerKey => $this->_dispatcher->getDefaultControllerName(),
                 $this->_actionKey     => $this->_dispatcher->getDefaultAction(),
                 $this->_moduleKey     => $this->_dispatcher->getDefaultModule()
             );
         }
 
         $this->_keysSet = true;
     }
 
     /**
      * Matches a user submitted path. Assigns and returns an array of variables
      * on a successful match.
      *
      * If a request object is registered, it uses its setModuleName(),
      * setControllerName(), and setActionName() accessors to set those values.
      * Always returns the values as an array.
      *
      * @param string  $path Path used to match against this routing map
      * @param boolean $partial
      * @return array An array of assigned values or a false on a mismatch
      */
     public function match($path, $partial = false)
     {
         $this->_setRequestKeys();
 
         $values = array();
         $params = array();
 
         if (!$partial) {
             $path = trim($path, self::URI_DELIMITER);
         } else {
             $matchedPath = $path;
         }
 
         if ($path != '') {
             $path = explode(self::URI_DELIMITER, $path);
 
             if ($this->_dispatcher && $this->_dispatcher->isValidModule($path[0])) {
                 $values[$this->_moduleKey] = array_shift($path);
                 $this->_moduleValid        = true;
             }
 
             if (count($path) && !empty($path[0])) {
                 $values[$this->_controllerKey] = array_shift($path);
             }
 
             if (count($path) && !empty($path[0])) {
                 $values[$this->_actionKey] = array_shift($path);
             }
 
             if ($numSegs = count($path)) {
                 for ($i = 0; $i < $numSegs; $i = $i + 2) {
                     $key          = urldecode($path[$i]);
                     $val          = isset($path[$i + 1]) ? urldecode($path[$i + 1]) : null;
                     $params[$key] = (isset($params[$key]) ? (array_merge((array)$params[$key], array($val))) : $val);
                 }
             }
         }
 
         if ($partial) {
             $this->setMatchedPath($matchedPath);
         }
 
         $this->_values = $values + $params;
 
         return $this->_values + $this->_defaults;
     }
 
     /**
      * Assembles user submitted parameters forming a URL path defined by this route
      *
      * @param array   $data  An array of variable and value pairs used as parameters
      * @param boolean $reset Weither to reset the current params
      * @param boolean $encode
      * @param boolean $partial
      * @return string Route path with user submitted parameters
      */
     public function assemble($data = array(), $reset = false, $encode = true, $partial = false)
     {
         if (!$this->_keysSet) {
             $this->_setRequestKeys();
         }
 
         $params = (!$reset) ? $this->_values : array();
 
         foreach ($data as $key => $value) {
             if ($value !== null) {
                 $params[$key] = $value;
             } elseif (isset($params[$key])) {
                 unset($params[$key]);
             }
         }
 
         $params += $this->_defaults;
 
         $url = '';
 
         if ($this->_moduleValid || array_key_exists($this->_moduleKey, $data)) {
             if ($params[$this->_moduleKey] != $this->_defaults[$this->_moduleKey]) {
                 $module = $params[$this->_moduleKey];
             }
         }
         unset($params[$this->_moduleKey]);
 
         $controller = $params[$this->_controllerKey];
         unset($params[$this->_controllerKey]);
 
         $action = $params[$this->_actionKey];
         unset($params[$this->_actionKey]);
 
         foreach ($params as $key => $value) {
             $key = ($encode) ? urlencode($key) : $key;
             if (is_array($value)) {
                 foreach ($value as $arrayValue) {
                     $arrayValue = ($encode) ? urlencode($arrayValue) : $arrayValue;
                     $url .= self::URI_DELIMITER . $key;
                     $url .= self::URI_DELIMITER . $arrayValue;
                 }
             } else {
                 if ($encode) {
                     $value = urlencode($value);
                 }
                 $url .= self::URI_DELIMITER . $key;
                 $url .= self::URI_DELIMITER . $value;
             }
         }
 
         if (!empty($url) || $action !== $this->_defaults[$this->_actionKey]) {
             if ($encode) {
                 $action = urlencode($action);
             }
             $url = self::URI_DELIMITER . $action . $url;
         }
 
         if (!empty($url) || $controller !== $this->_defaults[$this->_controllerKey]) {
             if ($encode) {
                 $controller = urlencode($controller);
             }
             $url = self::URI_DELIMITER . $controller . $url;
         }
 
         if (isset($module)) {
             if ($encode) {
                 $module = urlencode($module);
             }
             $url = self::URI_DELIMITER . $module . $url;
         }
 
         return ltrim($url, self::URI_DELIMITER);
     }
 
     /**
      * Return a single parameter of route's defaults
      *
      * @param string $name Array key of the parameter
      * @return string Previously set default
      */
     public function getDefault($name)
     {
         if (isset($this->_defaults[$name])) {
             return $this->_defaults[$name];
         }
     }
 
     /**
      * Return an array of defaults
      *
      * @return array Route defaults
      */
     public function getDefaults()
     {
         return $this->_defaults;
     }
 }