Zend Framework Module之多模块配置

摘要：该文将为你们简单介绍一下如何使用zend framework建立模块化的应用程序。

zend framework对多模块的支持是很好的，可是多是因为功能太过强大的缘故，部署起来并非很容易。许多人在使用过程当中都会遇到这样 那样的问题，并且zend framework如今已经到1.11版本了，网络上的不少资料都还停留在旧版本上，所以我在这里以当前的最新版本1.11为 例，来简单介绍一下如何使用zend framework建立模块化的应用程序。

一、准备工做

首先假设你已经部署了web服务器和php，并下载了zend framework的最新版本，建立了一个最原始的zend framework项 目，并能够访问默认的action了。你可使用zend framework工具来建立项目，具体操做参见使用zend framework建立项目。 固然也能够本身手动创建文件夹和文件，参见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_”

固然你也能够根据须要多添加几个，不过请注意最后面的下划线。

二、创建模块

如今咱们来建立一个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[]=0

这样，再访问http://localhost/webroot/public/admin，应该就能看到admin模块输出的内容了。

若是咱们要充分发挥模块的强大功能，咱们还须要为模块添加一个启动文件Bootstrap.php。它可使得你在事个模块中方便的使用类资源，models, filters, helpers等。在admin下新建Bootstrap.php，代码以下：

class Admin_Bootstrap extends Zend_Application_Module_Bootstrap{}

而且在application/Bootstrap.php文件里加入如下方法：

protectedfunction _initAppAutoload(){
$autoloader=new Zend_Application_Module_Autoloader(
array( ’namespace’=>’App’,'basePath’=>dirname(__FILE__), )
);
return$autoloader;
}

它将会自动加载models，filters，helpers等到咱们的默认模块。经过以上设置，咱们就能够在接下来的controllers里使用全部这些资源了。

三、设置布局

这里主要说明如何配置不一样的模块应用不一样的布局，关于布局的概念和基本的用法，请参见官方文档的建立布局和Zend_Layout入门。

对于通常页面，你可能须要使用一个布局文件，如三行两列式，而对于admin模块，你可能须要使用另外一种布局，如两列式。要达到这个目的能够采用两种方式。

第一种，布局脚本文件存放在统一的文件夹，如application/layout

能够在application下新建以下目录和文件：

application/layouts/scripts/layout.phtml

application/layouts/scripts/admin.phtml

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

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{
publicfunction 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{
publicfunction 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里去

protectedfunction _initLayoutHelper(){
$this->bootstrap(‘frontController’);
$layout= Zend_Controller_Action_HelperBroker::addHelper( new Rockux_Controller_Action_Helper_LayoutLoader());
}

再次访问http://localhost/webroot/public/admin，应当就能够看到使用指定的布局文件了。

若是要针对某个特定的controller使用特定的layout，能够在controller的init()方法里添加以下代码：

$layout= Zend_Layout::getMvcInstance();$layout->setLayout(‘layout_special’); 详细的请参见 ZendFramework官方文档 :http://framework.zend.com/manual/1.11/en/zend.controller.modular.html