走进Zend Framework框架编程(四)：Zend_Controller和引导文件 【转】

上一节的基本示例已经运行成功，说明ZF已经开始工作了。这一部分我首先引入Zend_Controller的概念，再对引导文件index.php做一个详细的解释。

1， 理解Zend_Controller Zend_Controller是ZF的MVC体系的核心部份。 Front Controller(前端控制器)设计模式具体是由Zend_Controller_Front静态类实现的，所有的请求都必须通过前端控制器，并基于请求的URL被分发(dispatch)到不同的控制器去来处理。 Zend_Controller体系具有可扩展性，可以通过继承已有的类，或者通过实现各种接口和继承抽象类来写自己的扩展类，也可以编写插件或者助手类(helper)来增强系统的功能。 Zend_Controller_Front类的声明和所有初始化工作，以及执行dispatch()方法等都是在Bootstrap文件即入口程序中完成的，在ZF中，通常就是指index.php文件。因为用户的所有请求都是从index.php进入的，所以需要配置Web服务器，把所有请求导向到index.php文件中，这些我们在前边已经完成了，而这里我们已经对其原因有了更深入的理解。

2， 理解ZF是如何处理HTTP请求的： 例如有一个URL请求地址http://host_name/controller_name/action_name。

其中host_name一般是一个域名，例如www.why100000.com。默认情况下，该URL的第一个部份controller_name会映射到一个控制器，第二个部份action_name则映射到控制器类中的Action（控制器类内部的一个方法）。在本例中，其服务器路径为/controller_name/action_name，则会映射到controller_name控制器和action_name这个Action。如果不存在该action，则会默认调用index这个action。如果控制器不存在，则会默认自动调用index控制器(按照Apache的命名惯例，将自动映射到DirectoryIndex文件)。

接下来，Zend_Controller的dispatcher会根据控制器的名称找到具体的控制器类。通常它会把控制器名称加上Controller。因此，上例中controller_name控制器与controller_name Controller类相对应。

类似地，action会映射到控制器类中的一个方法。默认情况下，会被转成小写字母，然后加上“Action”字符串。因此，上例中action_name这个action与 action_name Action相对应。于是最终我们访问URL调用的是 controller_name Controller-> action_name Action() 方法。

控制器类保存为controller文件夹下的一个php文件中，文件名前缀约定与controller类的名字相同。例如Controller_nameController.php。

现在我们根据以上约定创建一个控制器和Action方法： <?php class Controller_nameController extends Zend_Controller_Action { function action_nameAction() { …… } } ?> 以上代码需要以文件名Controller_nameController.php保存，并存放到controllers文件夹下。 ZF有一个约定，就是当url中不指定控制器名时，默认为index控制器；当不指定action名时，默认为index action。于是，当控制器名和action都不指定时，就执行index控制器类的indexAction方法，这时类文件形如： <?php class IndexController extends Zend_Controller_Action { function indexAction() { …… } } ?> 该代码保存为IndexController.php文件名。

一般的控制器类都有一个indexAction函数，作为控制器的默认方法。 注意在url中，控制器名和action可以同时省略：即形如http://host_name/ 也可以省略action名，执行indexAction方法，形如http://host_name/controller_name/ 但不能省略控制器名而指定action名，即 http://host_name//action_name 是不正确的。 形如http://host_name/xxx的地址，xxx被认为是控制器名。

对于我们上一节的示例，当用浏览器打开地址http://phpchica1.com:8080，其实执行的是IndexController控制器类的indexAction方法，执行了语句 echo "Hello PHPChina1.com！";

而我们在IndexController控制器类中再建立一个成员函数： function otherAction() { echo "this is other Action."; } 在浏览器地址栏输入http://phpchica1.com:8080/index/other,将会输出字符串“this is other Action.”。

3， 对引导（bootstrap）文件index.php的解释 error_reporting(E_ALL|E_STRICT);语句打开了错误输出开关，用于代码调试，正式发布的代码应该屏蔽错误信息。 date_default_timezone_set('Asia/Shanghai');设定时区，该语句不能省略。 set_include_path(……);很关键的语句。用于设定类库的包含路径，ZF的系统类库就是在这里指定的。注意如果php.ini文件里的include_path包含了ZF类库的路径，这里就可以不用包含../library路径。但是在自己的代码里指定ZF类库路径更方便一些，一般推荐这么做。../App_phpchina.com/models/路径下包含我们自己开发的自定义类文件。没有自定义类文件，可以不用包含该路径。get_include_path再取得php.ini的其他包含路径，一同指定我们的应用程序使用。 include "Zend/Loader.php";语句装载ZF的类加载器。Zend/Loader.php正是从../library路径下取得的。 Zend_Loader::registerAutoload();自动加载类。该语句可以分别用以下两段代码代替，效果相同： 第一段代码： function __autoload($class) { Zend_Loader::loadClass($class); } 第二段代码： Zend_Loader::loadClass('Zend_Controller_Front'); $fc = Zend_Controller_Front::getInstance();取得Zend_Controller_Front类实例。 $fc->setControllerDirectory(……);指定一组控制器文件路径，参数是数组。让前端控制器知道从哪里去找我们的控制器类。如果仅有一个控制器文件夹，也可以写成： $fc->setControllerDirectory('../App_www.mydomain.com/controllers'); $fc->throwExceptions(true);设置抛出错误信息。 $fc->setParam('xxx', true);格式的语句用于设置一些参数。 其中$fc->setParam('noViewRenderer', true);指明不使用视图，false 是默认值。 $fc->dispatch();语句开始执行分发，导向到请求的控制器执行后续代码。

这是一个功能较少的、典型的bootstrap引导文件，每个ZF应用中，该文件大同小异，只是个别参数设置不同。这个文件可以作为一个模板，拷贝到其他ZF应用中使用。这个文件与ZF应用的文件夹结构有直接关系，配置时一定要仔细。调整一些参数后可以使ZF有一些其他的额外功能。这点我们以后还会接触到。

4， ZF中请求URL的格式 Zend Framework的控制器 Zend_Controller使网站支持“干净的URL”。它把对控制器、方法的请求和参数的传递变形为对文件夹的访问形式。URL的完整格式为： http://host_name/controller_name/action_name/param1/ value1/param2/ value2… 除过前边的host_name外，controller_name和action_name为控制器和方法名，后边的残出和值必须一一对应。 传递的参数，在action方法中以 $this->_getParam("参数名");的方法来取得其值。 因为有严格的对应关系，一般在有参数传递的情况下，控制器和action的名字都不能省略，否则会出现歧义。 我们现在在 C:/Program Files/Apache Software Foundation/Apache2.2/htdocs/app_phpchina1.com /controllers 文件夹下建立一个NewsController.php文件，内容为： <?php class NewsController extends Zend_Controller_Action { function indexAction() { echo "Welcome to News!"; }

function pageAction() { $id = $this->_getParam("id"); echo "ID: ".$id."<BR>"; $type = $this->_getParam("type"); echo "TYPE: ".$type."<BR>"; } } ?> 然后我们以http://phpchina1.com:8080/news/page/id/001/type/typename地址访问该文件，会得到以下显示结果，可以看到已经正确的获得了传递的参数： ID: 001 TYPE: typename

我们看到，ZF访问框架内的控制器方法，不是通过从url中访问控制器类php文件来实现的，而是在index.php中前端控制器的控制下对对应的控制器及其方法进行访问，一切过程和细节都被ZF框架屏蔽了，我们只要写出正确的url就能访问到对应的程序逻辑。

我们可以试着访问http://phpchina1.com:8080/index.php地址，实际上执行的还是IndexController控制器的indexAction方法，输出字符串“Hello PHPChina1.com！”。而想直接访问IndexController.php和NewsController.php文件，我们甚至连它们的url路径是什么都无法知道。

张庆（网眼） 网眼视界：http://blog.why100000.com 2008-6-10