zend framework多模块多布局配置

许多人在使用过程中都会遇到这样那样的问题，而且zend framework现在已经到1.11版本了，网络上的很多资料都还停留在旧版本上，因此我在这里以当前的最新版本1.11为例，来简单介绍一下如何使用zend framework创建模块化的应用程序。由于今后框架的版本升级，有些内容可能会过时，请及时参阅最新的。

1、准备工作

首先假设你已经部署了web服务器和php，并下载了zend framework的最新版本，创建了一个最原始的zend framework项目，并可以访问默认的action了。你可以使用zend framework工具来创建项目，具体操作参见。当然也可以自己手动建立文件夹和文件，参见。

简单地看一下默认的几个重要目录。
首先是public，它不但存放了程序的入口点index.php，还可以存放图片，css，javascript文件等。
其次是library，用于存放一些类库，包括你自己定义的或第三方的类库。
然后是test，用于存放单元测试等测试文件的。
最后，也是和我们这里要讲的关系最大的目录——application。进到application目录下，会有以下目录：
configs：存放配置文件，一般会有一个主配置文件application.ini；
controllers：操制器，如默认的indexcontroller.php；
models：存放业务逻辑，数据模型等文件；
views：视图层的脚本，一般以.phtml为后缀名；
modules：模块目录，使用工具默认选项自动生成的是没有这个目录的，需要手动添加。modules底下可以包含多个以模块名命名的文件夹，如admin，默认是default，一个文件夹代表一个模块，其下的目录结构与application目录类似，又可以包含controllers，models，views等目录。需要注意的是模块下的controllers下面的文件的类名请加上模块名前缀，如application/modules/admin/controllers/indexcontroller.php的类名为admin_indexcontroller。

如果你需要在项目中方便的使用你自己写的一些类库（如名称空间是rockux），或是第三方的类库，可以修改application.ini文件，添加以下行：

autoloadernamespaces.rockux = "rockux_"
autoloadernamespaces.thirdparty = "thirdpartylibrary_"

当然你也可以根据需要多添加几个，不过请注意最后面的下划线。

2、建立模块
现在我们来创建一个admin模块，目录如下：
application/modules/admin/controllers
application/modules/admin/models
application/modules/admin/views
application/modules/admin/views/scripts
application/modules/admin/views/helpers
application/modules/admin/views/filters
并创建以下文件：
application/modules/admin/controllers/indexcontroller.php（类名为admin_indexcontroller）
application/modules/admin/views/scripts/index/index.phtml

除了新建模块文件之外，还需要更改配置文件application.ini，删除以下行，如果有的话：

resources.frontcontroller.controllerdirectory = application_path"/controllers"

再加上如下行：

resources.frontcontroller.moduledirectory = application_path "/modules"
resources.frontcontroller.modulecontrollerdirectoryname = "controllers"
resources.frontcontroller.defaultmodule = "default"
resources.modules[]

这样，再访问http://localhost/admin，应该就能看到admin模块输出的内容了。
如果我们要充分发挥模块的强大功能，我们还需要为模块添加一个启动文件——bootstrap.php。它可以使得你在事个模块中方便的使用类资源，models, filters, helpers等。在admin下新建bootstrap.php，代码如下：

class admin_bootstrap extends zend_application_module_bootstrap
{
}

并且在application/bootstrap.php文件里加入以下方法：

protected function _initappautoload()
{
$autoloader = new zend_application_module_autoloader(array(
'namespace' => 'app',
'basepath' => dirname(__file__),
));
return $autoloader;
}

resources.layout.layoutpath = application_path "/layouts/scripts"
resources.layout.layout = "layout"
admin.resources.layout.layout = "admin"

第二种，不同模块的布局脚本文件分别存放在各自的模块文件夹下
可以在application下新建如下目录和文件：
application/layouts/scripts/layout.phtml
application/modules/admin/layouts/scripts/layout.phtml

在配置文件application.ini中添加如下几行：

resources.layout.layoutpath = application_path "/layouts/scripts"
resources.layout.layout = "layout"
admin.resources.layout.layoutpath = application_path "/modules/admin/layouts/scripts"

不论是第一种还是第二种，这时如果访问http://localhost/admin，你会发现系统并没有使用期望的admin.phtml作为布局文件，而是使用了默认的layout.phtml。这是因为admin那行配置并不是系统默认能处理的有效配置，所以我们要自己来处理它。

我们新建文件：library/rockux/controller/action/helper/layoutloader.php，

针对第一种情况代码如下：

class rockux_controller_action_helper_layoutloader extends zend_controller_action_helper_abstract
{

public function predispatch()
{
$bootstrap = $this->getactioncontroller()
->getinvokearg('bootstrap');
$config = $bootstrap->getoptions();
$module = $this->getrequest()->getmodulename();
if (isset($config[$module]['resources']['layout']['layout'])) {
$layoutscript = $config[$module]['resources']['layout']['layout'];
$this->getactioncontroller()
->gethelper('layout')
->setlayout($layoutscript);
}
}

}

针对第二种情况代码如下：

class rockux_controller_action_helper_layoutloader extends zend_controller_action_helper_abstract
{

public function predispatch()
{
$bootstrap = $this->getactioncontroller()
->getinvokearg('bootstrap');
$config = $bootstrap->getoptions();
$module = $this->getrequest()->getmodulename();
if (isset($config[$module]['resources']['layout']['layoutpath'])) {
$layoutpath =
$config[$module]['resources']['layout']['layoutpath'];
$this->getactioncontroller()
->gethelper('layout')
->setlayoutpath($layoutpath);
}
}
}

接下来我们还需要将它添加到application/bootstrap.php里去

protected function _initlayouthelper()
{
$this->bootstrap('frontcontroller');
$layout = zend_controller_action_helperbroker::addhelper(
new rockux_controller_action_helper_layoutloader());
}

再次访问http://localhost/admin，应当就可以看到使用指定的布局文件了。
如果要针对某个特定的controller使用特定的layout，可以在controller的init()方法里添加如下代码：

$layout = zend_layout::getmvcinstance();
$layout->setlayout('layout_special');