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