ZendFramework的MVC实现的核心机制是通过Zend_Controller_Front前端控制器,用于初始化请求环境,处理请求,路由分发,完成响应操作,Zend_Controller_Front采用的单例模式,所以一个应用只有一个前端控制器。如果需要前端控制器提供一些特殊功能,可以继承Zend_Controller_Front自定义前端控制器。
主要方法
getInstance()
用来获取前端控制器实例。创建前端控制器对象的唯一方法。
$front = Zend_Controller_Front::getInstance();
setControllerDirectory() 和 addControllerDirectory()
setControllerDirectory()设置动作控制器action controller类文件的存放位置。参数可以是路径字符串或者关联数组。
例如:
//路径是相对于应用的/application目录下 // 字符串 $front->setControllerDirectory('../application/controllers'); // 关联数组 $front->setControllerDirectory(array( 'default' => '../application/controllers', 'blog' => '../modules/blog/controllers', 'news' => '../modules/news/controllers', )); // Add a 'foo' module directory: $front->addControllerDirectory('../modules/foo/controllers', 'foo');
Note: 如果使用addControllerDirectory()时不带模块名,将会为default模块设定目录——如果目录已设定,就覆盖掉。
可以通过getControllerDirectory()获取控制器目录的当前设置;它将返回一个模块/目录对关联数组。
addModuleDirectory() 和 getModuleDirectory()
前端控制器的一个功能是你可以 定义一个模块目录结构 来创建独立的组件,被叫做“模块”。
每个模块位于自己的目录并和缺省模块的目录结构一样 - 例如,它至少 有个 "controllers" 字目录和 "views" 子目录以及其它应用子目录。
addModuleDirectory() 让你传递一个包含一个或多个模块目录的目录名。 然后进行扫描并把它们作为控制器目录添加到前端控制器。
然后,如果你想确定特定模块或当前模块路径,调用 getModuleDirectory(), 可选地传递模块名来获得模块目录。
dispatch()
dispatch(Zend_Controller_Request_Abstract $request = null, Zend_Controller_Response_Abstract $response = null)完成前端控制器最繁重的工作。该方法带有可选的参数请求对象和/或响应对象,允许开发人员为每一个传入定制的对象。
如果没有请求或者响应对象传入,dispatch()将检查先前注册的对象并使用,如果没有发现则创建默认的对象版本(它们两个都默认使用HTTP对象)。
类似的,dispatch()先检查已注册的路由器(router)和分发器(dispatcher)对象,如果没有发现则实例化它们的默认版本。
分发过程有三个不同的事件:路由(Routing)、分发(Dispatching)、响应(Response)
路由只发生一次,当调用dispatch()时利用请求对象中的值。分发发生在一个循环中;请求可能指示分发多个动作,或者控制器或插件可能重置请求对象,强制分发附加的动作。所有都完成后,前端控制器返回响应对象。
run()
Zend_Controller_Front::run($path)是静态方法,只带一个参数,就是指向包含控制器的目录的路径。它首先通过getInstance()获取前端控制器实例,然后通过setControllerDirectory()注册传入的路径,最后分发。
基本上,如果不要求定制前端控制器环境,run()是一个很方便的建立前端控制器环境的方法。
Zend_Controller_Front::run('../application/controllers');
环境访问器方法
除了上面所列的方法以外,还有很多访问器方法可以影响前端控制器环境 —— 因而也影响前端控制器代理(delegate)的类的环境。
resetInstance()方法清除当前的所有设置。主要用来测试,不过,在希望将几个前端控制器连锁的地方也是很有用的(but it can also be used for instances where you wish to chain together multiple front controllers)。
(set|get)DefaultControllerName()方法可以为默认的控制器指定另外一个名字(否则使用'index'),以及获取当前值。它们将代理分发器。
(set|get)DefaultAction()方法可以为默认的动作指定另外一个名字(否则使用'index'),以及获取当前值。它们将代理分发器。
(set|get)Request()方法指定分发过程中使用的请求类或对象,以及获取当前的请求对象。设置请求对象时,可以传入一个请求类的名字,该方法将加载类文件并创建实例。
(set|get)Router()方法指定分发过程中使用的路由器类或对象,以及获取当前对象。设置路由器时,可以传入一个路由器类的名字,该方法将加载类文件并创建实例。
获取路由器对象的时候,首先检查是否已有一个,如果没有,创建默认的路由器实例(rewrite路由器)。
(set|get)BaseUrl()方法指定路由请求时剥离(strip)的基地址(base URL),以及获取当前值。这个值将在路由前提供给路由器。