Yiiframework框架之模块

模块是一个独立的单元,包含视图、控制器和其它组件,它和一个应用的区别是不能单独部署。

创建模块

首先,模块目录放在你的应用的modules目录中,我们可以使用yii自带的gii生成器来创建基本的结构,开启gii的方法是修改你的应用config/main.php文件中如下内容

	'modules'=>array(

		'gii'=>array(

			'class'=>'system.gii.GiiModule',

			'password'=>'你的密码访问时需要输入',

		 	// If removed, Gii defaults to localhost only. Edit carefully to taste.

			'ipFilters'=>array('127.0.0.1','::1'),

		),

	),

  下面通过 你的应用/index.php?r=gii 访问gii,打开以后选择,左边菜单的Module Generator选项。你将会看到下面的画面

Yiiframework框架之模块

在Module ID 输入模块的名称,我这里输入admin,然后点击Preview按钮。如下图所示,它向你展示了所有将会被生成的文件,允许你在新建之前预览他们 :

Yiiframework框架之模块

然后点击Generate按钮,来生成所有文件。因为Web服务器进程需要写入权限,所以确保你的/protected文件夹对于该应用程序是可写入的。

配置使用这个模块

我们对主配置文件 : protected/config/main.php进行配置,如下的代码需要被修改,添加了'admin', :

'modules'=>array( 
'gii'=>array(
'class'=>'system.gii.GiiModule',
'password'=>'你的密码',
)
,
'admin',
)
,

  保存上面的修改后后,我们的新admin模块已经可以使用了。我们可以先通过以下地址访问一下index.php?r=admin/default/index

在模块中使用layout

我们访问index.php?r=admin/default/index会发现,模块使用了你的应用下的/protected/views/layouts/main.php文件,而我们可能希望使用/protected/modules/admin/views/layouts/main.php文件,让admin模块拥有独立的布局视图。

我们在protected\modules\admin\controllers\DefaultController.php添加如下代码,

public $layout='application.modules.admin.views.layouts.main'; 

  我们把从/protected/views/layouts/main.php 拷贝到/protected/modules/admin/views/layouts/,稍作修改,这样模块就拥有了独立的布局视图.

 在模块中使用Assets

添加新的模块时,一般会包含图像文件,CSS文件,JavaScript文件等。

模块可以直接从网站主目录中引用。但是如果想要创建一个模块能够在任何地方引用,并且能够避免命名冲突,就要用到assets了。

过程是(这里模块名是admin):

1、把需要用到的资源放在modules/admin/assets下。

2、然后通过 CAssetManager,Yii::app()->assetManager能够自动的将私有资源publish到公共目录下 网站目录/assets

3、Yii会自动在网站目录的/assets下创建一个随机不冲突的文件夹,如2b31b42b,并把你的modules/admin/assets目录下的文件拷贝过去。

例如我的模块是Admin,文件路径通过如下代码获得,修改protected\modules\admin\AdminModule.php文件,

class AdminModule extends CWebModule
{

/*开始*/
private$_assetsUrl;

publicfunction getAssetsUrl()
{
if($this->_assetsUrl===null)
$this->_assetsUrl=Yii::app()->getAssetManager()->publish(Yii::getPathOfAlias('application.modules.admin.assets'));
return$this->_assetsUrl;
}

publicfunction setAssetsUrl($value)
{
$this->_assetsUrl=$value;
}

/*结束*/

}

然后,在/protected/modules/admin/views/layouts/main.php中

使用$this->module->assetsUrl就可以调用你的css等文件了。

代码如下,

<link rel="stylesheet" type="text/css" href="<?php echo $this->module->assetsUrl; ?>/css/screen.css" media="screen, projection" />

  4,通过如上操作,该模块只要把admin目录拷贝,就可以多次复用了。

 

你可能感兴趣的:(framework)