问题:
在yii中,一个controller会包含若干个action。有时为了重用或代码管理等目的,我们希望这些action可以单独定义成一个类,然后在 controller中使用。那么在yii中要如何实现呢?
假设我们有这样一个例子
TestController.php,文件位于wwwroot/blog/controllers/,wwwroot对应http://www.example.com/
代码如下:
代码语言:javascript复制<?php
class TestController extends Controller {
public function actionHello($name='ball'){
echo "hello $name";
}
}
代码功能很简单,接收一个名字参数,显示hello $name。
访问:
http://www.example.com/blog/index.php?r=test/hello&name=xuan 页面显示:
hello xuan 注: actionHello函数的$name参数最好有默认值。不然当url中无$name参数时页面会报错。
实现
下面我们要做的是,将actionHello形成一个单独的类,在TestController中调用它。
1. 建立wwwroot/blog/controllers/test/目录
目录名定为test是yii推荐的写法,建议action所在的目录与对应的controller同名,当然不这样也没有关系。
2.在test目录中创建HelloAction.php文件。
文件内容如下:
代码语言:javascript复制<?php
class HelloAction extends CAction{
public function run($name='ball'){
echo "Hello $name";
}
}
注意:
1.此类一定要继承自CAction类
2.必须有run方法供外部调用
3.run方法的参数,即为url中的请求参数。当然也可以通过$_GET的方式在函数内部取得
详见 http://www.yiiframework.com/doc/guide/1.1/en/basics.controller#action一节中的Action Parameter Binding
3.修改TestController.php
代码语言:javascript复制<?php
class TestController extends Controller {
public function actions(){
return array('hello'=>array(
'class'=>'application.controllers.test.HelloAction',
)
);
}
}
好了,看看我们的成果吧,访问:
http://www.example.com/blog/index.php?r=test/hello&name=xuan 页面显示:
hello xuan
注: 对于'class'=>'application.controllers.test.HelloAction'在官方例子中你也许会看到类似'class'=>'HelloAction'的写法。 不要困惑,其实目的是一样。本例中之所以写为“application.controllers.test.HelloAction”,是因为test目录不在yii自动加载范畴。 如果之前有导入: Yii::import('application.controllers.test.*'); 那么 'class'=>' HelloAction'就可以正常工作了。
More
1. 如果TestController同时定义了上述actions规则,又包含了actionHello方法会怎么样呢?
答案是优先执行actionHello方法,actions相应的规则不生效。
2.controller中如果有特殊的参数要传给actoin,如何处理?
通过actoins方法中的规则传递。
代码类似
代码语言:javascript复制return array(
'action'=>array(
'class'=>'path.to.ActionClass',
'property1'=>'value1',
'property2'=>'value2',
),
);
但action中必须有相应的property属性,且设为public。 对应本文的例子,假设TestController要传一个somthingToSay给HelloAction,代码如下: TestController.php
代码语言:javascript复制<?php
class TestController extends Controller {
public function actions(){
return array('hello'=>array(
'class'=>'application.controllers.test.HelloAction',
'somethingToSay'=>'welcome to yii',
));
}
}
HelloAction.php
代码语言:javascript复制<?php
class HelloAction extends CAction{
public $somethingToSay = '';
public function run($name='ball'){
echo "Hello $name, {$this->somethingToSay}.";
}
}
访问 http://www.example.com/blog/index.php?r=test/hello&name=xuan 页面显示: Hello xuan, welcome to yii.