走进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路径是什么都无法知道。

张庆（网眼）文章出处phpchina