详解PHP的Yii框架中的Controller控制器(3)

?r=post/view&id=123: $id 会填入'123',$version 仍为 null 空因为没有version请求参数;
?r=post/view&id=123&version=2: $id 和 $version 分别填入 '123' 和 '2'`;
?r=post/view: 会抛出yii\web\BadRequestHttpException 异常 因为请求没有提供参数给必须赋值参数$id;
?r=post/view&id[]=123: 会抛出yii\web\BadRequestHttpException 异常 因为$id 参数收到数字值 ['123']而不是字符串.
如果想让操作参数接收数组值,需要指定$id为array,如下所示:

public function actionView(array $id, $version = null) { // ... }

现在如果请求为 ?r=post/view&id[]=123, 参数 $id 会使用数组值['123'], 如果请求为?r=post/view&id=123, 参数 $id 会获取相同数组值,因为无类型的'123'会自动转成数组。

上述例子主要描述网页应用的操作参数,对于控制台应用,更多详情请参阅控制台命令。

默认操作

每个控制器都有一个由 yii\base\Controller::defaultAction 属性指定的默认操作, 当路由 只包含控制器ID,会使用所请求的控制器的默认操作。

默认操作默认为 index,如果想修改默认操作,只需简单地在控制器类中覆盖这个属性,如下所示:

namespace app\controllers; use yii\web\Controller; class SiteController extends Controller { public $defaultAction = 'home'; public function actionHome() { return $this->render('home'); } }

控制器动作参数绑定 
从版本 1.1.4 开始,Yii 提供了对自动动作参数绑定的支持。就是说,控制器动作可以定义命名的参数,参数的值将由 Yii 自动从 $_GET 填充。

为了详细说明此功能,假设我们需要为 PostController 写一个 create 动作。此动作需要两个参数:

       category:一个整数,代表帖子(post)要发表在的那个分类的ID。

       language:一个字符串,代表帖子所使用的语言代码。

从 $_GET 中提取参数时,我们可以不再下面这种无聊的代码了:

class PostController extends CController { public function actionCreate() { if(isset($_GET['category'])) $category=(int)$_GET['category']; else throw new CHttpException(404,'invalid request'); if(isset($_GET['language'])) $language=$_GET['language']; else $language='en'; // ... fun code starts here ... } }

现在使用动作参数功能,我们可以更轻松的完成任务:

class PostController extends CController { public function actionCreate($category, $language='en') { $category = (int)$category; echo 'Category:'.$category.'/Language:'.$language; // ... fun code starts here ... } }

注意我们在动作方法 actionCreate 中添加了两个参数。这些参数的名字必须和我们想要从 $_GET 中提取的名字一致。当用户没有在请求中指定 $language 参数时,这个参数会使用默认值 en 。由于 $category 没有默认值,如果用户没有在 $_GET 中提供 category 参数,将会自动抛出一个 CHttpException (错误代码 400) 异常。

从版本1.1.5开始,Yii已经支持数组的动作参数。使用方法如下:

class PostController extends CController { public function actionCreate(array $categories) { // Yii will make sure $categories be an array } }

控制器生命周期

处理一个请求时,应用主体 会根据请求路由创建一个控制器,控制器经过以下生命周期来完成请求:

在控制器创建和配置后,yii\base\Controller::init() 方法会被调用。

控制器根据请求操作ID创建一个操作对象:

如果操作ID没有指定,会使用yii\base\Controller::defaultAction默认操作ID;

如果在yii\base\Controller::actions()找到操作ID,会创建一个独立操作;

如果操作ID对应操作方法,会创建一个内联操作;

否则会抛出yii\base\InvalidRouteException异常。

控制器按顺序调用应用主体、模块(如果控制器属于模块)、控制器的 beforeAction() 方法;

如果任意一个调用返回false,后面未调用的beforeAction()会跳过并且操作执行会被取消; action execution will be cancelled.

默认情况下每个 beforeAction() 方法会触发一个 beforeAction 事件,在事件中你可以追加事件处理操作;

控制器执行操作:

请求数据解析和填入到操作参数;

控制器按顺序调用控制器、模块(如果控制器属于模块)、应用主体的 afterAction() 方法;

默认情况下每个 afterAction() 方法会触发一个 afterAction 事件,在事件中你可以追加事件处理操作;

应用主体获取操作结果并赋值给响应.


最佳实践

在设计良好的应用中,控制器很精练,包含的操作代码简短; 如果你的控制器很复杂,通常意味着需要重构,转移一些代码到其他类中。

归纳起来,控制器:

可访问请求 数据;

可根据请求数据调用 模型 的方法和其他服务组件;

可使用视图构造响应;

不应处理应被模型处理的请求数据;

应避免嵌入HTML或其他展示代码,这些代码最好在 视图中处理.

您可能感兴趣的文章:

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/02dcb9d3478b96360243e940ab3e6966.html