10.12. MVC 异常

10.12.1. 介绍

Zend Framework 中的MVC元件利用了一个前端控制器,这意味着到一个站点的所有请求都将通过单一入口。因此,所有的异常最终将起泡到前端控制器,开发人员可在一个位置处理这些异常。

但是,异常消息以及回溯信息可能含有敏感的系统信息,比如SQL语句,文件位置等等。为了保护站点,Zend_Controller_Front 默认将捕捉所有异常并注册到响应对象,响应对象默认不会显示异常消息。

10.12.2. 如何处理异常?

MVC元件已经建立了几种机制来处理异常。

  • 默认地,错误处理器插件(error handler plugin) 将会被注册并激活。这个插件可以处理:

    • 控制器或动作缺失导致的异常

    • 动作控制器中发生的异常

    它作为一个postDispatch()插件,检查分发器、动作控制器或者其他的异常是否发生。如果发生异常,它将转向一个错误处理控制器。

    该处理器会涵盖大多数异常情况,并能够优美的处理控制器或者动作缺失异常。

  • Zend_Controller_Front::throwExceptions()

    通过向该方法传入一个true值,可以通知前端控制器,由开发人员来处理异常,而不是让响应对象收集或者使用错误处理器插件。例如:

    $front->throwExceptions(true);
    try	{
    	$front->dispatch();
    } catch	(Exception $e) {
    	// handle exceptions yourself
    }
    
    

    这是向前端控制器中加入定制处理所有可能异常的最简单方式。

  • Zend_Controller_Response_Abstract::renderExceptions()

    通过向该方法中传入一个true值,可以让响应对象渲染(render)异常消息,当渲染响应对象时追踪异常(backtrace)。这种情况下,将会显示程序中引发的所有异常。推荐只在非生产(non-production)环境中使用。

  • Zend_Controller_Front::returnResponse()Zend_Controller_Response_Abstract::isException().

    Zend_Controller_Front::returnResponse()传入一个true值, Zend_Controller_Front::dispatch() 将不渲染响应对象,而是将其返回。获得响应对象后,可通过isException()测试是否捕捉到异常,然后通过getException()获取异常。例如:

    $front->returnResponse(true);
    $response =	$front->dispatch();
    if ($response->isException()) {
    	$exceptions	= $response->getException();
    	// handle exceptions ...
    } else {
    	$response->sendHeaders();
    	$response->outputBody();
    }
    
    

    这种方式相对于Zend_Controller_Front::throwExceptions()的主要优点在于,可以在异常处理后有条件的渲染响应对象。不像错误处理器插件,该方法能够捕捉到控制器链中的任何异常。

10.12.3. 可能遭遇的MVC异常

各种MVC元件--请求,路由器,分发器,动作控制器,响应对象--在同一事件中可能每一个都会抛出异常。一些异常可能根据情况被忽略,其他的则提示开发人员考虑程序的结构。

比如:

  • 如果请求一个无效的控制器,Zend_Controller_Dispatcher::dispatch() 默认会抛出一个异常。推荐采用两种方式来处理。

    • 设置useDefaultControllerAlways参数。

      在前端控制器或者分发器中,加入下列代码:

      $front->setParam('useDefaultControllerAlways', true);
      
      // or
      
      $dispatcher->setParam('useDefaultControllerAlways',	true);
      
      

      设置了这个标志,分发器将调用默认的控制器和动作,而不是抛出异常。该方法的缺点是用户访问站点时的URL拼写错误,依然会被解析并显示默认页,这将严重破坏搜索引擎的优化。

    • dispatch()抛出的异常是一个包含文本'Invalid controller specified'的Zend_Controller_Dispatcher_Exception。使用前一节描述的方法捕捉异常,然后重定向到一个一般性的错误页面或者主页。

  • 如果由于动作不存在而无法分发,Zend_Controller_Action::__call() 将会抛出一个Zend_Controller_Action_Exception异常。很有可能,像这些例子一样,你会在控制器中调用默认的动作。这些方法包括:

    • 子类化Zend_Controller_Action并重写__call() 方法。例如:

      class My_Controller_Action extends Zend_Controller_Action
      {
      	public function	__call($method,	$args)
      	{
      		if ('Action' ==	substr($method,	-6)) {
      			$controller	= $this->getRequest()->getControllerName();
      			$url = '/' . $controller . '/index';
      			return $this->_redirect($url);
      		}
      
      		throw new Exception('Invalid method');
      	}
      }
      
      

      上面的例子拦截所有未定义的动作调用,并重定向到控制器中的默认动作。

    • 子类化Zend_Controller_Dispatcher 并重写getAction() 方法来验证动作的存在。例如:

      class My_Controller_Dispatcher extends Zend_Controller_Dispatcher
      {
      	public function	getAction($request)
      	{
      		$action	= $request->getActionName();
      		if (empty($action))	{
      			$action	= $this->getDefaultAction();
      			$request->setActionName($action);
      			$action	= $this->formatActionName($action);
      		} else {
      			$controller	= $this->getController();
      			$action		= $this->formatActionName($action);
      			if (!method_exists($controller,	$action)) {
      				$action	= $this->getDefaultAction();
      				$request->setActionName($action);
      				$action	= $this->formatActionName($action);
      			}
      		}
      
      		return $action;
      	}
      }
      
      

      上面的代码检查请求的动作在控制类中是否存在,不存在的话,将动作重置为默认动作。

      这个方法好在你可以在最终分发前透明的改变动作。然而,同样意味着URL中的拼写错误会导致不正确的分发,这对搜索引擎的优化很不利。

    • 使用Zend_Controller_Action::preDispatch()或者Zend_Controller_Plugin_Abstract::preDispatch()来识别无效的动作。

      通过子类化Zend_Controller_Action并修改preDispatch()方法,你可以修改所有的控制器转向另一个动作,或者在实际分发动作之前重定向。代码看起来与上面重写__call()方法类似。

      也可以选择在一个全局插件中检查该信息。其优点在于保持动作控制器的独立性;如果程序由大量的动作控制器组成,并且不是所有的动作控制器都从同一类继承,这种方法可以统一的控制各个类。

      例如:

      class My_Controller_PreDispatchPlugin extends Zend_Controller_Plugin_Abstract
      {
      	public function	preDispatch(Zend_Controller_Request_Abstract $request)
      	{
      		$dispatcher	= 
      		    Zend_Controller_Front::getInstance()->getDispatcher();
      		$controller	= $dispatcher->getController($request);
      		if (!$controller) {
      			$controller	= 
      			    $dispatcher->getDefaultControllerName($request);
      		}
      		$action		= $dispatcher->getAction($request);
      
      		if (!method_exists($controller,	$action)) {
      			$defaultAction = $dispatcher->getDefaultAction();
      			$controllerName	= $request->getControllerName();
      			$response =	
      			    Zend_Controller_Front::getInstance()->getResponse();
      			$response->setRedirect('/' . $controllerName . 
      			                       '/' . $defaultAction);
      			$response->sendHeaders();
      			exit;
      		}
      	}
      }
      
      

      这个例子中,先检查请求的动作在控制器中是否有效。如果无效,重定向到控制器默认的动作,并立即退出脚本的执行。