Zend Framework教程之分发器Zend_Controller_Dispatcher用法详解

本文实例讲述了Zend Framework教程之分发器Zend_Controller_Dispatcher用法。分享给大家供大家参考,具体如下:

分发器的具体实现

Zend Framework的分发器Zend_Controller_Dispatcher设计主要有,如下类和接口组成:

├── Dispatcher
│   ├── Abstract.php
│   ├── Exception.php
│   ├── Interface.php
│   └── Standard.php

Zend_Controller_Dispatcher_Interface

定义了分发器提供的基本和标准功能。

interface Zend_Controller_Dispatcher_Interface
{
  public function formatControllerName($unformatted);
  public function formatModuleName($unformatted);
  public function formatActionName($unformatted);
  public function isDispatchable(Zend_Controller_Request_Abstract $request);
  public function setParam($name, $value);
  public function setParams(array $params);
  public function getParam($name);
  public function getParams();
  public function clearParams($name = null);
  public function setResponse(Zend_Controller_Response_Abstract $response = null);
  public function getResponse();
  public function addControllerDirectory($path, $args = null);
  public function setControllerDirectory($path);
  public function getControllerDirectory();
  public function dispatch(Zend_Controller_Request_Abstract $request, Zend_Controller_Response_Abstract $response);
  public function isValidModule($module);
  public function getDefaultModule();
  public function getDefaultControllerName();
  public function getDefaultAction();
}

Zend_Controller_Dispatcher_Abstract

实现了Zend_Controller_Dispatcher_Interface接口,提供了分发器提供的基本和标准功能的抽象父类。

<?php
/** Zend_Controller_Dispatcher_Interface */
require_once 'Zend/Controller/Dispatcher/Interface.php';
abstract class Zend_Controller_Dispatcher_Abstract implements Zend_Controller_Dispatcher_Interface
{
  protected $_defaultAction = 'index';
  protected $_defaultController = 'index';
  protected $_defaultModule = 'default';
  protected $_frontController;
  protected $_invokeParams = array();
  protected $_pathDelimiter = '_';
  protected $_response = null;
  protected $_wordDelimiter = array('-', '.');
  public function __construct(array $params = array())
  {
    $this->setParams($params);
  }
  public function formatControllerName($unformatted)
  {
    return ucfirst($this->_formatName($unformatted)) . 'Controller';
  }
  public function formatActionName($unformatted)
  {
    $formatted = $this->_formatName($unformatted, true);
    return strtolower(substr($formatted, 0, 1)) . substr($formatted, 1) . 'Action';
  }
  public function _verifyDelimiter($spec)
  {
    if (is_string($spec)) {
      return (array) $spec;
    } elseif (is_array($spec)) {
      $allStrings = true;
      foreach ($spec as $delim) {
        if (!is_string($delim)) {
          $allStrings = false;
          break;
        }
      }
      if (!$allStrings) {
        require_once 'Zend/Controller/Dispatcher/Exception.php';
        throw new Zend_Controller_Dispatcher_Exception('Word delimiter array must contain only strings');
      }
      return $spec;
    }
    require_once 'Zend/Controller/Dispatcher/Exception.php';
    throw new Zend_Controller_Dispatcher_Exception('Invalid word delimiter');
  }
  public function getWordDelimiter()
  {
    return $this->_wordDelimiter;
  }
  public function setWordDelimiter($spec)
  {
    $spec = $this->_verifyDelimiter($spec);
    $this->_wordDelimiter = $spec;
    return $this;
  }
  public function getPathDelimiter()
  {
    return $this->_pathDelimiter;
  }
  public function setPathDelimiter($spec)
  {
    if (!is_string($spec)) {
      require_once 'Zend/Controller/Dispatcher/Exception.php';
      throw new Zend_Controller_Dispatcher_Exception('Invalid path delimiter');
    }
    $this->_pathDelimiter = $spec;
    return $this;
  }
  protected function _formatName($unformatted, $isAction = false)
  {
    // preserve directories
    if (!$isAction) {
      $segments = explode($this->getPathDelimiter(), $unformatted);
    } else {
      $segments = (array) $unformatted;
    }
    foreach ($segments as $key => $segment) {
      $segment    = str_replace($this->getWordDelimiter(), ' ', strtolower($segment));
      $segment    = preg_replace('/[^a-z0-9 ]/', '', $segment);
      $segments[$key] = str_replace(' ', '', ucwords($segment));
    }
    return implode('_', $segments);
  }
  public function getFrontController()
  {
    if (null === $this->_frontController) {
      require_once 'Zend/Controller/Front.php';
      $this->_frontController = Zend_Controller_Front::getInstance();
    }
    return $this->_frontController;
  }
  public function setFrontController(Zend_Controller_Front $controller)
  {
    $this->_frontController = $controller;
    return $this;
  }
  public function setParam($name, $value)
  {
    $name = (string) $name;
    $this->_invokeParams[$name] = $value;
    return $this;
  }
  public function setParams(array $params)
  {
    $this->_invokeParams = array_merge($this->_invokeParams, $params);
    return $this;
  }
  public function getParam($name)
  {
    if(isset($this->_invokeParams[$name])) {
      return $this->_invokeParams[$name];
    }
    return null;
  }
  public function getParams()
  {
    return $this->_invokeParams;
  }
  public function clearParams($name = null)
  {
    if (null === $name) {
      $this->_invokeParams = array();
    } elseif (is_string($name) && isset($this->_invokeParams[$name])) {
      unset($this->_invokeParams[$name]);
    } elseif (is_array($name)) {
      foreach ($name as $key) {
        if (is_string($key) && isset($this->_invokeParams[$key])) {
          unset($this->_invokeParams[$key]);
        }
      }
    }
    return $this;
  }
  public function setResponse(Zend_Controller_Response_Abstract $response = null)
  {
    $this->_response = $response;
    return $this;
  }
  public function getResponse()
  {
    return $this->_response;
  }
  public function setDefaultControllerName($controller)
  {
    $this->_defaultController = (string) $controller;
    return $this;
  }
  public function getDefaultControllerName()
  {
    return $this->_defaultController;
  }
  public function setDefaultAction($action)
  {
    $this->_defaultAction = (string) $action;
    return $this;
  }
  public function getDefaultAction()
  {
    return $this->_defaultAction;
  }
  public function setDefaultModule($module)
  {
    $this->_defaultModule = (string) $module;
    return $this;
  }
  public function getDefaultModule()
  {
    return $this->_defaultModule;
  }
}

Zend_Controller_Dispatcher_Standard

ZendFramework继承抽象类Zend_Controller_Dispatcher_Abstract,定义了Zend_Controller_Dispatcher_Standard。Zend_Controller_Dispatcher_Standard是ZendFramework提供的基本的分发器,完成了分发功能。

<?php
/** Zend_Loader */
require_once 'Zend/Loader.php';
/** Zend_Controller_Dispatcher_Abstract */
require_once 'Zend/Controller/Dispatcher/Abstract.php';
class Zend_Controller_Dispatcher_Standard extends Zend_Controller_Dispatcher_Abstract
{
  protected $_curDirectory;
  protected $_curModule;
  protected $_controllerDirectory = array();
  public function __construct(array $params = array())
  {
    parent::__construct($params);
    $this->_curModule = $this->getDefaultModule();
  }
  public function addControllerDirectory($path, $module = null)
  {
    if (null === $module) {
      $module = $this->_defaultModule;
    }
    $module = (string) $module;
    $path  = rtrim((string) $path, '/\\');
    $this->_controllerDirectory[$module] = $path;
    return $this;
  }
  public function setControllerDirectory($directory, $module = null)
  {
    $this->_controllerDirectory = array();
    if (is_string($directory)) {
      $this->addControllerDirectory($directory, $module);
    } elseif (is_array($directory)) {
      foreach ((array) $directory as $module => $path) {
        $this->addControllerDirectory($path, $module);
      }
    } else {
      require_once 'Zend/Controller/Exception.php';
      throw new Zend_Controller_Exception('Controller directory spec must be either a string or an array');
    }
    return $this;
  }
  public function getControllerDirectory($module = null)
  {
    if (null === $module) {
      return $this->_controllerDirectory;
    }
    $module = (string) $module;
    if (array_key_exists($module, $this->_controllerDirectory)) {
      return $this->_controllerDirectory[$module];
    }
    return null;
  }
  public function removeControllerDirectory($module)
  {
    $module = (string) $module;
    if (array_key_exists($module, $this->_controllerDirectory)) {
      unset($this->_controllerDirectory[$module]);
      return true;
    }
    return false;
  }
  public function formatModuleName($unformatted)
  {
    if (($this->_defaultModule == $unformatted) && !$this->getParam('prefixDefaultModule')) {
      return $unformatted;
    }
    return ucfirst($this->_formatName($unformatted));
  }
  public function formatClassName($moduleName, $className)
  {
    return $this->formatModuleName($moduleName) . '_' . $className;
  }
  public function classToFilename($class)
  {
    return str_replace('_', DIRECTORY_SEPARATOR, $class) . '.php';
  }
  public function isDispatchable(Zend_Controller_Request_Abstract $request)
  {
    $className = $this->getControllerClass($request);
    if (!$className) {
      return false;
    }
    $finalClass = $className;
    if (($this->_defaultModule != $this->_curModule)
      || $this->getParam('prefixDefaultModule'))
    {
      $finalClass = $this->formatClassName($this->_curModule, $className);
    }
    if (class_exists($finalClass, false)) {
      return true;
    }
    $fileSpec  = $this->classToFilename($className);
    $dispatchDir = $this->getDispatchDirectory();
    $test    = $dispatchDir . DIRECTORY_SEPARATOR . $fileSpec;
    return Zend_Loader::isReadable($test);
  }
  public function dispatch(Zend_Controller_Request_Abstract $request, Zend_Controller_Response_Abstract $response)
  {
    $this->setResponse($response);
    /**
     * Get controller class
     */
    if (!$this->isDispatchable($request)) {
      $controller = $request->getControllerName();
      if (!$this->getParam('useDefaultControllerAlways') && !empty($controller)) {
        require_once 'Zend/Controller/Dispatcher/Exception.php';
        throw new Zend_Controller_Dispatcher_Exception('Invalid controller specified (' . $request->getControllerName() . ')');
      }
      $className = $this->getDefaultControllerClass($request);
    } else {
      $className = $this->getControllerClass($request);
      if (!$className) {
        $className = $this->getDefaultControllerClass($request);
      }
    }
    /**
     * Load the controller class file
     */
    $className = $this->loadClass($className);
    /**
     * Instantiate controller with request, response, and invocation
     * arguments; throw exception if it's not an action controller
     */
    $controller = new $className($request, $this->getResponse(), $this->getParams());
    if (!($controller instanceof Zend_Controller_Action_Interface) &&
      !($controller instanceof Zend_Controller_Action)) {
      require_once 'Zend/Controller/Dispatcher/Exception.php';
      throw new Zend_Controller_Dispatcher_Exception(
        'Controller "' . $className . '" is not an instance of Zend_Controller_Action_Interface'
      );
    }
    /**
     * Retrieve the action name
     */
    $action = $this->getActionMethod($request);
    /**
     * Dispatch the method call
     */
    $request->setDispatched(true);
    // by default, buffer output
    $disableOb = $this->getParam('disableOutputBuffering');
    $obLevel  = ob_get_level();
    if (empty($disableOb)) {
      ob_start();
    }
    try {
      $controller->dispatch($action);
    } catch (Exception $e) {
      // Clean output buffer on error
      $curObLevel = ob_get_level();
      if ($curObLevel > $obLevel) {
        do {
          ob_get_clean();
          $curObLevel = ob_get_level();
        } while ($curObLevel > $obLevel);
      }
      throw $e;
    }
    if (empty($disableOb)) {
      $content = ob_get_clean();
      $response->appendBody($content);
    }
    // Destroy the page controller instance and reflection objects
    $controller = null;
  }
  public function loadClass($className)
  {
    $finalClass = $className;
    if (($this->_defaultModule != $this->_curModule)
      || $this->getParam('prefixDefaultModule'))
    {
      $finalClass = $this->formatClassName($this->_curModule, $className);
    }
    if (class_exists($finalClass, false)) {
      return $finalClass;
    }
    $dispatchDir = $this->getDispatchDirectory();
    $loadFile  = $dispatchDir . DIRECTORY_SEPARATOR . $this->classToFilename($className);
    if (Zend_Loader::isReadable($loadFile)) {
      include_once $loadFile;
    } else {
      require_once 'Zend/Controller/Dispatcher/Exception.php';
      throw new Zend_Controller_Dispatcher_Exception('Cannot load controller class "' . $className . '" from file "' . $loadFile . "'");
    }
    if (!class_exists($finalClass, false)) {
      require_once 'Zend/Controller/Dispatcher/Exception.php';
      throw new Zend_Controller_Dispatcher_Exception('Invalid controller class ("' . $finalClass . '")');
    }
    return $finalClass;
  }
  public function getControllerClass(Zend_Controller_Request_Abstract $request)
  {
    $controllerName = $request->getControllerName();
    if (empty($controllerName)) {
      if (!$this->getParam('useDefaultControllerAlways')) {
        return false;
      }
      $controllerName = $this->getDefaultControllerName();
      $request->setControllerName($controllerName);
    }
    $className = $this->formatControllerName($controllerName);
    $controllerDirs   = $this->getControllerDirectory();
    $module = $request->getModuleName();
    if ($this->isValidModule($module)) {
      $this->_curModule  = $module;
      $this->_curDirectory = $controllerDirs[$module];
    } elseif ($this->isValidModule($this->_defaultModule)) {
      $request->setModuleName($this->_defaultModule);
      $this->_curModule  = $this->_defaultModule;
      $this->_curDirectory = $controllerDirs[$this->_defaultModule];
    } else {
      require_once 'Zend/Controller/Exception.php';
      throw new Zend_Controller_Exception('No default module defined for this application');
    }
    return $className;
  }
  public function isValidModule($module)
  {
    if (!is_string($module)) {
      return false;
    }
    $module    = strtolower($module);
    $controllerDir = $this->getControllerDirectory();
    foreach (array_keys($controllerDir) as $moduleName) {
      if ($module == strtolower($moduleName)) {
        return true;
      }
    }
    return false;
  }
  public function getDefaultControllerClass(Zend_Controller_Request_Abstract $request)
  {
    $controller = $this->getDefaultControllerName();
    $default  = $this->formatControllerName($controller);
    $request->setControllerName($controller)
        ->setActionName(null);
    $module       = $request->getModuleName();
    $controllerDirs   = $this->getControllerDirectory();
    $this->_curModule  = $this->_defaultModule;
    $this->_curDirectory = $controllerDirs[$this->_defaultModule];
    if ($this->isValidModule($module)) {
      $found = false;
      if (class_exists($default, false)) {
        $found = true;
      } else {
        $moduleDir = $controllerDirs[$module];
        $fileSpec = $moduleDir . DIRECTORY_SEPARATOR . $this->classToFilename($default);
        if (Zend_Loader::isReadable($fileSpec)) {
          $found = true;
          $this->_curDirectory = $moduleDir;
        }
      }
      if ($found) {
        $request->setModuleName($module);
        $this->_curModule  = $this->formatModuleName($module);
      }
    } else {
      $request->setModuleName($this->_defaultModule);
    }
    return $default;
  }
  public function getDispatchDirectory()
  {
    return $this->_curDirectory;
  }
  public function getActionMethod(Zend_Controller_Request_Abstract $request)
  {
    $action = $request->getActionName();
    if (empty($action)) {
      $action = $this->getDefaultAction();
      $request->setActionName($action);
    }
    return $this->formatActionName($action);
  }
}

前端控制器和分发器

<?php
/** Zend_Loader */
require_once 'Zend/Loader.php';
/** Zend_Controller_Action_HelperBroker */
require_once 'Zend/Controller/Action/HelperBroker.php';
/** Zend_Controller_Plugin_Broker */
require_once 'Zend/Controller/Plugin/Broker.php';
class Zend_Controller_Front
{
  protected $_baseUrl = null;
  protected $_controllerDir = null;
  protected $_dispatcher = null;
  protected static $_instance = null;
  protected $_invokeParams = array();
  protected $_moduleControllerDirectoryName = 'controllers';
  protected $_plugins = null;
  protected $_request = null;
  protected $_response = null;
  protected $_returnResponse = false;
  protected $_router = null;
  protected $_throwExceptions = false;
  protected function __construct()
  {
    $this->_plugins = new Zend_Controller_Plugin_Broker();
  }
  private function __clone()
  {
  }
  public static function getInstance()
  {
    if (null === self::$_instance) {
      self::$_instance = new self();
    }
    return self::$_instance;
  }
  public function resetInstance()
  {
    $reflection = new ReflectionObject($this);
    foreach ($reflection->getProperties() as $property) {
      $name = $property->getName();
      switch ($name) {
        case '_instance':
          break;
        case '_controllerDir':
        case '_invokeParams':
          $this->{$name} = array();
          break;
        case '_plugins':
          $this->{$name} = new Zend_Controller_Plugin_Broker();
          break;
        case '_throwExceptions':
        case '_returnResponse':
          $this->{$name} = false;
          break;
        case '_moduleControllerDirectoryName':
          $this->{$name} = 'controllers';
          break;
        default:
          $this->{$name} = null;
          break;
      }
    }
    Zend_Controller_Action_HelperBroker::resetHelpers();
  }
  public static function run($controllerDirectory)
  {
    self::getInstance()
      ->setControllerDirectory($controllerDirectory)
      ->dispatch();
  }
  public function addControllerDirectory($directory, $module = null)
  {
    $this->getDispatcher()->addControllerDirectory($directory, $module);
    return $this;
  }
  public function setControllerDirectory($directory, $module = null)
  {
    $this->getDispatcher()->setControllerDirectory($directory, $module);
    return $this;
  }
  public function getControllerDirectory($name = null)
  {
    return $this->getDispatcher()->getControllerDirectory($name);
  }
  public function removeControllerDirectory($module)
  {
    return $this->getDispatcher()->removeControllerDirectory($module);
  }
  public function addModuleDirectory($path)
  {
    try{
      $dir = new DirectoryIterator($path);
    } catch(Exception $e) {
      require_once 'Zend/Controller/Exception.php';
      throw new Zend_Controller_Exception("Directory $path not readable", 0, $e);
    }
    foreach ($dir as $file) {
      if ($file->isDot() || !$file->isDir()) {
        continue;
      }
      $module  = $file->getFilename();
      // Don't use SCCS directories as modules
      if (preg_match('/^[^a-z]/i', $module) || ('CVS' == $module)) {
        continue;
      }
      $moduleDir = $file->getPathname() . DIRECTORY_SEPARATOR . $this->getModuleControllerDirectoryName();
      $this->addControllerDirectory($moduleDir, $module);
    }
    return $this;
  }
  public function getModuleDirectory($module = null)
  {
    if (null === $module) {
      $request = $this->getRequest();
      if (null !== $request) {
        $module = $this->getRequest()->getModuleName();
      }
      if (empty($module)) {
        $module = $this->getDispatcher()->getDefaultModule();
      }
    }
    $controllerDir = $this->getControllerDirectory($module);
    if ((null === $controllerDir) || !is_string($controllerDir)) {
      return null;
    }
    return dirname($controllerDir);
  }
  public function setModuleControllerDirectoryName($name = 'controllers')
  {
    $this->_moduleControllerDirectoryName = (string) $name;
    return $this;
  }
  public function getModuleControllerDirectoryName()
  {
    return $this->_moduleControllerDirectoryName;
  }
  public function setDefaultControllerName($controller)
  {
    $dispatcher = $this->getDispatcher();
    $dispatcher->setDefaultControllerName($controller);
    return $this;
  }
  public function getDefaultControllerName()
  {
    return $this->getDispatcher()->getDefaultControllerName();
  }
  public function setDefaultAction($action)
  {
    $dispatcher = $this->getDispatcher();
    $dispatcher->setDefaultAction($action);
    return $this;
  }
  public function getDefaultAction()
  {
    return $this->getDispatcher()->getDefaultAction();
  }
  public function setDefaultModule($module)
  {
    $dispatcher = $this->getDispatcher();
    $dispatcher->setDefaultModule($module);
    return $this;
  }
  public function getDefaultModule()
  {
    return $this->getDispatcher()->getDefaultModule();
  }
  public function setRequest($request)
  {
    ...........................
    return $this;
  }
  public function getRequest()
  {
    return $this->_request;
  }
  public function setRouter($router)
  {
    ....................
    return $this;
  }
  public function getRouter()
  {
    ..................
    return $this->_router;
  }
  public function setBaseUrl($base = null)
  {
    ..............
    return $this;
  }
  public function getBaseUrl()
  {
    return $this->_baseUrl;
  }
  /**
   * Set the dispatcher object. The dispatcher is responsible for
   * taking a Zend_Controller_Dispatcher_Token object, instantiating the controller, and
   * call the action method of the controller.
   *
   * @param Zend_Controller_Dispatcher_Interface $dispatcher
   * @return Zend_Controller_Front
   */
  public function setDispatcher(Zend_Controller_Dispatcher_Interface $dispatcher)
  {
    $this->_dispatcher = $dispatcher;
    return $this;
  }
  /**
   * Return the dispatcher object.
   *
   * @return Zend_Controller_Dispatcher_Interface
   */
  public function getDispatcher()
  {
    /**
     * Instantiate the default dispatcher if one was not set.
     */
    if (!$this->_dispatcher instanceof Zend_Controller_Dispatcher_Interface) {
      require_once 'Zend/Controller/Dispatcher/Standard.php';
      $this->_dispatcher = new Zend_Controller_Dispatcher_Standard();
    }
    return $this->_dispatcher;
  }
  public function setResponse($response)
  {..................
    return $this;
  }
  public function getResponse()
  {
    return $this->_response;
  }
  public function setParam($name, $value)
  {
    $name = (string) $name;
    $this->_invokeParams[$name] = $value;
    return $this;
  }
  public function setParams(array $params)
  {
    $this->_invokeParams = array_merge($this->_invokeParams, $params);
    return $this;
  }
  public function getParam($name)
  {
    if(isset($this->_invokeParams[$name])) {
      return $this->_invokeParams[$name];
    }
    return null;
  }
  public function getParams()
  {
    return $this->_invokeParams;
  }
  public function clearParams($name = null)
  {
    if (null === $name) {
      $this->_invokeParams = array();
    } elseif (is_string($name) && isset($this->_invokeParams[$name])) {
      unset($this->_invokeParams[$name]);
    } elseif (is_array($name)) {
      foreach ($name as $key) {
        if (is_string($key) && isset($this->_invokeParams[$key])) {
          unset($this->_invokeParams[$key]);
        }
      }
    }
    return $this;
  }
  public function registerPlugin(Zend_Controller_Plugin_Abstract $plugin, $stackIndex = null)
  {
    $this->_plugins->registerPlugin($plugin, $stackIndex);
    return $this;
  }
  public function unregisterPlugin($plugin)
  {
    $this->_plugins->unregisterPlugin($plugin);
    return $this;
  }
  public function hasPlugin($class)
  {
    return $this->_plugins->hasPlugin($class);
  }
  public function getPlugin($class)
  {
    return $this->_plugins->getPlugin($class);
  }
  public function getPlugins()
  {
    return $this->_plugins->getPlugins();
  }
  public function throwExceptions($flag = null)
  {
    .....................
    return $this->_throwExceptions;
  }
  public function returnResponse($flag = null)
  {
    ................
    return $this->_returnResponse;
  }
  /**
   * Dispatch an HTTP request to a controller/action.
   *
   * @param Zend_Controller_Request_Abstract|null $request
   * @param Zend_Controller_Response_Abstract|null $response
   * @return void|Zend_Controller_Response_Abstract Returns response object if returnResponse() is true
   */
  public function dispatch(Zend_Controller_Request_Abstract $request = null, Zend_Controller_Response_Abstract $response = null)
  {
    if (!$this->getParam('noErrorHandler') && !$this->_plugins->hasPlugin('Zend_Controller_Plugin_ErrorHandler')) {
      // Register with stack index of 100
      require_once 'Zend/Controller/Plugin/ErrorHandler.php';
      $this->_plugins->registerPlugin(new Zend_Controller_Plugin_ErrorHandler(), 100);
    }
    if (!$this->getParam('noViewRenderer') && !Zend_Controller_Action_HelperBroker::hasHelper('viewRenderer')) {
      require_once 'Zend/Controller/Action/Helper/ViewRenderer.php';
      Zend_Controller_Action_HelperBroker::getStack()->offsetSet(-80, new Zend_Controller_Action_Helper_ViewRenderer());
    }
    /**
     * Instantiate default request object (HTTP version) if none provided
     */
    if (null !== $request) {
      $this->setRequest($request);
    } elseif ((null === $request) && (null === ($request = $this->getRequest()))) {
      require_once 'Zend/Controller/Request/Http.php';
      $request = new Zend_Controller_Request_Http();
      $this->setRequest($request);
    }
    /**
     * Set base URL of request object, if available
     */
    if (is_callable(array($this->_request, 'setBaseUrl'))) {
      if (null !== $this->_baseUrl) {
        $this->_request->setBaseUrl($this->_baseUrl);
      }
    }
    /**
     * Instantiate default response object (HTTP version) if none provided
     */
    if (null !== $response) {
      $this->setResponse($response);
    } elseif ((null === $this->_response) && (null === ($this->_response = $this->getResponse()))) {
      require_once 'Zend/Controller/Response/Http.php';
      $response = new Zend_Controller_Response_Http();
      $this->setResponse($response);
    }
    /**
     * Register request and response objects with plugin broker
     */
    $this->_plugins
       ->setRequest($this->_request)
       ->setResponse($this->_response);
    /**
     * Initialize router
     */
    $router = $this->getRouter();
    $router->setParams($this->getParams());
    /**
     * Initialize dispatcher
     */
    $dispatcher = $this->getDispatcher();
    $dispatcher->setParams($this->getParams())
          ->setResponse($this->_response);
    // Begin dispatch
    try {
      /**
       * Route request to controller/action, if a router is provided
       */
      /**
      * Notify plugins of router startup
      */
      $this->_plugins->routeStartup($this->_request);
      try {
        $router->route($this->_request);
      } catch (Exception $e) {
        if ($this->throwExceptions()) {
          throw $e;
        }
        $this->_response->setException($e);
      }
      /**
      * Notify plugins of router completion
      */
      $this->_plugins->routeShutdown($this->_request);
      /**
       * Notify plugins of dispatch loop startup
       */
      $this->_plugins->dispatchLoopStartup($this->_request);
      /**
       * Attempt to dispatch the controller/action. If the $this->_request
       * indicates that it needs to be dispatched, move to the next
       * action in the request.
       */
      do {
        $this->_request->setDispatched(true);
        /**
         * Notify plugins of dispatch startup
         */
        $this->_plugins->preDispatch($this->_request);
        /**
         * Skip requested action if preDispatch() has reset it
         */
        if (!$this->_request->isDispatched()) {
          continue;
        }
        /**
         * Dispatch request
         */
        try {
          $dispatcher->dispatch($this->_request, $this->_response);
        } catch (Exception $e) {
          if ($this->throwExceptions()) {
            throw $e;
          }
          $this->_response->setException($e);
        }
        /**
         * Notify plugins of dispatch completion
         */
        $this->_plugins->postDispatch($this->_request);
      } while (!$this->_request->isDispatched());
    } catch (Exception $e) {
      if ($this->throwExceptions()) {
        throw $e;
      }
      $this->_response->setException($e);
    }
    /**
     * Notify plugins of dispatch loop completion
     */
    try {
      $this->_plugins->dispatchLoopShutdown();
    } catch (Exception $e) {
      if ($this->throwExceptions()) {
        throw $e;
      }
      $this->_response->setException($e);
    }
    if ($this->returnResponse()) {
      return $this->_response;
    }
    $this->_response->sendResponse();
  }
}

以上对Zend_Controller_Front和Zend_Controller_Dispatcher做了简单的标记,通过分析代码不难看出,基本的运行机制。

分发发生在前端控制器中的一个循环(loop)中。分发之前,前端控制器通过路由请求,找到用户指定的模块、控制器、动作和可选参数。然后进入分发循环,分发请求。

分发器需要大量数据完成任务——它需要知道如何格式化控制器和动作的名称,到哪儿找到控制器类文件,模块名是否有效,以及基于其它可用信息判定请求是否能分发的API。

每次迭代(iteration)过程开始时,在请求对象中设置一个标志指示该动作已分发。如果在动作或者前/后分发(pre/postDispatch)插件重置了该标志,分发循环将继续下去并试图分发新的请求。通过改变请求中的控制器或者动作并重置已分发标志,开发人员可以定制执行一个请求链。

控制这种分发过程的动作控制器方法是_forward();在任意的pre/postDispatch()或者动作中调用该方法,并传入动作、控制器、模块、以及可选的附加参数,就可以进入新的动作。

自定义分发器

Zend_Controller_Dispatcher_Interface定义了下列所有分发器需要实现的方法。

不过大多数情况下,只需要简单地扩展抽象类Zend_Controller_Dispatcher_Abstract,其中已经定义好了上面的大部分方法。或者扩展Zend_Controller_Dispatcher_Standard类,基于标准分发器来修改功能。

需要子类化分发器的可能原因包括:期望在动作控制器中使用不同的类和方法命名模式,或者期望使用不同的分发方式,比如分发到控制器目录下的动作文件,而不是控制器类的动作方法。

更多关于zend相关内容感兴趣的读者可查看本站专题:《Zend FrameWork框架入门教程》、《php优秀开发框架总结》、《Yii框架入门及常用技巧总结》、《ThinkPHP入门教程》、《php面向对象程序设计入门教程》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》

希望本文所述对大家PHP程序设计有所帮助。

(0)

相关推荐

  • Zend Framework实现自定义过滤器的方法

    本文实例讲述了Zend Framework实现自定义过滤器的方法.分享给大家供大家参考,具体如下: 创建自定义的过滤器 代码: <?php require_once 'Zend/Filter/Interface.php'; class MyFilter implements Zend_Filter_Interface{ public function filter($value){ $badlist = array("梨","草莓","苹果"

  • Zend Framework分发器用法示例

    本文实例讲述了Zend Framework分发器用法.分享给大家供大家参考,具体如下: 分发是取得请求对象,提取其中的模块名.控制器名.动作名以及可选参数,然后实例化控制器并调用其中动作的整个过程. 如果其中的模块.控制器或动作没有找到,将使用默认值. Zend_Controller_Dispatcher_Standard类指定每个控制器和动作的默认值为index,模块的默认值为default. 该类允许开发者通过setDEfaultController()方法.setDefaultAction

  • Zend Framework 2.0事件管理器(The EventManager)入门教程

    概述 EventManger是一个为以下使用情况设计的组件: 复制代码 代码如下: 实现简单的主题/观察者模式 实现面向切面的设计 实现事件驱动的架构 基本的架构允许你添加和解除指定事件的侦听器,无论是在一个实例基础还是一个共享的集合:触发事件:终止侦听器的执行. 快速入门 通常,你将会在一个类中创建一个EventManager. 复制代码 代码如下: use Zend\EventManager\EventManagerInterface; use Zend\EventManager\Event

  • Zend Framework常用校验器详解

    本文实例讲述了Zend Framework常用校验器.分享给大家供大家参考,具体如下: Date日期校验器 代码: <?php require_once 'Zend/Validate/Date.php'; function c_date($date){ $validator = new Zend_Validate_Date(); if($validator->isValid($date)){ echo "输入的日期格式:"; echo $date."有效!<

  • Zend Framework路由器用法实例详解

    本文实例讲述了Zend Framework路由器用法.分享给大家供大家参考,具体如下: 路由是一个过程,在这个过程中它去除URI的端点(跟着基本URL的URI部分),并将其分解成参数来决定哪个模块.哪个控制器和哪个动作应该接受请求. 模块.控制器.动作.及其参数被打包到Zend_Controller_Request_Http对象. 使用路由器 为了正确使用路由器,必须对其进行初始化操作. 创建路由器可以通过前端控制器实例的getRouter()方法来实现.该方法不需要任何参数,执行该方法可以返回

  • Zend Framework过滤器Zend_Filter用法详解

    本文实例讲述了Zend Framework过滤器Zend_Filter用法.分享给大家供大家参考,具体如下: 引言:过滤器是对输入内容进行过滤,清除其中不符合过滤规则的内容,并将其余内容返回的过程. Zend中有个Zend_Filter组件用来实现过滤的功能.其中有个Zend_Filter_Interface子类,该子类为实现一般过滤器提供了接口. 要实现过滤器类,需要实现该接口中一个名为filter()的方法. 下面通过实例来演示如何使用Zend_Filter中定义的过滤器,该例演示如何实现字

  • Zend Framework校验器Zend_Validate用法详解

    本文实例讲述了Zend Framework校验器Zend_Validate用法.分享给大家供大家参考,具体如下: 引言: 是对输入内容进行检查,并生成一个布尔结果来表明内容是否被成功校验的机制. 如果isValid()方法返回False,子类的getMessage()方法将返回一个消息数组来解释校验失败的原因. 为了正确地返回消息与错误内容,对于isValid()方法的每次调用,都需要清除前一个isValid()方法调用所导致的消息和错误. 案例: <?php require_once 'Zen

  • Zend Framework前端控制器用法示例

    本文实例讲述了Zend Framework前端控制器用法.分享给大家供大家参考,具体如下: 常用方法 1.getInstance() 功能:用于获取前端控制器实例. 代码如下: <?php $front = Zend_Controller_Front::getInstance(); 执行上述代码,将创建一个前端控制器实例. 2.setControllerDirectory() 功能:用于通知分发器到何处查找动作控制器action controller类文件. 3.getControllerDir

  • Zend Framework教程之前端控制器Zend_Controller_Front用法详解

    本文实例讲述了Zend Framework教程之前端控制器Zend_Controller_Front用法.分享给大家供大家参考,具体如下: 主要功能 ZendFramework的MVC实现的核心机制是通过Zend_Controller_Front前端控制器,用于初始化请求环境,处理请求,路由分发,完成响应操作,Zend_Controller_Front采用的单例模式,所以一个应用只有一个前端控制器.如果需要前端控制器提供一些特殊功能,可以继承Zend_Controller_Front自定义前端控

  • Zend Framework动作控制器用法示例

    本文实例讲述了Zend Framework动作控制器用法.分享给大家供大家参考,具体如下: 动作控制器简介 为了使用Zend_Controller_Action类,需要在实际控制器类中把它子类化. 代码: <?php class FooController extends Zend_Controller_Action{ public function barAction(){ //do something } public function bazAction(){ //do something

随机推荐