zend framework多模块多布局配置 关键词:模块,布局,layout,配置zend framework对多模块的支持是很好的,但是可能是由于功能太过强大的缘故,部署起来并不是很容易。许多人在使用过程中都会遇到这样那样的问题,而且 zend framework现在已经到1.11版本了,网络上的很多资料都还停留在旧版本上,因此我在这里以当前的最新版本1.11为例,来简单介绍一下如何使用 zend framework创建模块化的应用程序。由于今后框架的版本升级,有些内容可能会过时,请及时参阅最新的使用手册。 1、准备工作首先假设你已经部署了web服务器和php,并下载了zend framework的最新版本,创建了一个最原始的zend framework项目,并可以访问默认的action了。你可以使用zend framework工具来创建项目,具体操作参见使用zend framework创建项目。当然也可以自己手动建立文件夹和文件,参见zend framework推荐的项目目录结构。 简单地看一下默认的几个重要目录。 如果你需要在项目中方便的使用你自己写的一些类库(如名称空间是Rockux),或是第三方的类库,可以修改application.ini文件,添加以下行:
autoloaderNamespaces.rockux
=
"Rockux_"
autoloaderNamespaces.thirdParty = "ThirdPartyLibrary_" 当然你也可以根据需要多添加几个,不过请注意最后面的下划线。 2、建立模块现在我们来创建一个admin模块,目录如下: 除了新建模块文件之外,还需要更改配置文件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 ; } 它将会自动加载models,filters,helpers等到我们的默认模块。通过以上设置,我们就可以在接下来的controllers里使用所有这些资源了。 3、设置布局这里主要说明如何配置不同的模块应用不同的布局,关于布局的概念和基本的用法,请参见官方文档的创建布局和Zend_Layout入门。 对于一般页面,你可能需要使用一个布局文件,如三行两列式,而对于admin模块,你可能需要使用另一种布局,如两列式。要达到这个目的可以采用两种方式。 在配置文件application.ini中添加如下几行:
resources.layout.layoutPath
= APPLICATION_PATH
"/layouts/scripts"
resources.layout.layout = "layout" admin.resources.layout.layout = "admin" 第二种,不同模块的布局脚本文件分别存放在各自的模块文件夹下 在配置文件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,应当就可以看到使用指定的布局文件了。
$layout
= Zend_Layout
::
getMvcInstance
(
)
;
$layout -> setLayout ( 'layout_special' ) ; |