©
이 문서에서는 PHP 중국어 웹사이트 매뉴얼 풀어 주다
控制器是 MVC 模式中的一部分, 是继承yii\base\Controller类的对象,负责处理请求和生成响应。 具体来说,控制器从应用主体接管控制后会分析请求数据并传送到模型, 传送模型结果到视图,最后生成输出响应信息。
控制器由 操作 组成,它是执行终端用户请求的最基础的单元,一个控制器可有一个或多个操作。
如下示例显示包含两个操作view
and create
的控制器post
:
namespace app\controllers;
use Yii;
use app\models\Post;
use yii\web\Controller;
use yii\web\NotFoundHttpException;
class PostController extends Controller{
public function actionView($id)
{
$model = Post::findOne($id);
if ($model === null) {
throw new NotFoundHttpException;
}
return $this->render('view', [
'model' => $model,
]);
}
public function actionCreate()
{
$model = new Post;
if ($model->load(Yii::$app->request->post()) && $model->save()) {
return $this->redirect(['view', 'id' => $model->id]);
} else {
return $this->render('create', [
'model' => $model,
]);
}
}
}
在操作 view
(定义为 actionView()
方法)中, 代码首先根据请求模型ID加载 模型, 如果加载成功,会渲染名称为view
的视图并显示,否则会抛出一个异常。
在操作 create
(定义为 actionCreate()
方法)中, 代码相似. 先将请求数据填入模型, 然后保存模型,如果两者都成功,会跳转到ID为新创建的模型的view
操作,否则显示提供用户输入的create
视图。
终端用户通过所谓的路由寻找到操作,路由是包含以下部分的字符串:
路由使用如下格式:
ControllerID/ActionID
如果属于模块下的控制器,使用如下格式:
ModuleID/ControllerID/ActionID
如果用户的请求地址为 http://hostname/index.php?r=site/index
, 会执行site
控制器的index
操作。 更多关于处理路由的详情请参阅 路由 一节。
在yii\web\Application网页应用中,控制器应继承yii\web\Controller 或它的子类。 同理在yii\console\Application控制台应用中,控制器继承yii\console\Controller 或它的子类。 如下代码定义一个 site
控制器:
namespace app\controllers;
use yii\web\Controller;
class SiteController extends Controller{
}
通常情况下,控制器用来处理请求有关的资源类型,因此控制器ID通常为和资源有关的名词。 例如使用article
作为处理文章的控制器ID。
控制器ID应仅包含英文小写字母、数字、下划线、中横杠和正斜杠, 例如 article
和 post-comment
是真是的控制器ID,article?
,PostComment
, admin\post
不是控制器ID。
控制器Id可包含子目录前缀,例如 admin/article
代表 yii\base\Application::controllerNamespace控制器命名空间下 admin
子目录中article
控制器。 子目录前缀可为英文大小写字母、数字、下划线、正斜杠,其中正斜杠用来区分多级子目录(如 panels/admin
)。
控制器ID遵循以下规则衍生控制器类名:
Controller
后缀;下面为一些示例,假设yii\base\Application::controllerNamespace控制器命名空间为 app\controllers
:
article
对应 app\controllers\ArticleController
;post-comment
对应 app\controllers\PostCommentController
;admin/post-comment
对应 app\controllers\admin\PostCommentController
;adminPanels/post-comment
对应 app\controllers\adminPanels\PostCommentController
.控制器类必须能被 自动加载,所以在上面的例子中, 控制器article
类应在 别名 为@app/controllers/ArticleController.php
的文件中定义, 控制器admin/post2-comment
应在@app/controllers/admin/Post2CommentController.php
文件中。
补充: 最后一个示例
admin/post2-comment
表示你可以将控制器放在 yii\base\Application::controllerNamespace控制器命名空间下的子目录中, 在你不想用 模块 的情况下给控制器分类,这种方式很有用。
可通过配置 yii\base\Application::controllerMap 来强制上述的控制器ID和类名对应, 通常用在使用第三方不能掌控类名的控制器上。
配置 应用配置 中的application configuration,如下所示:
[
'controllerMap' => [
// 用类名申明 "account" 控制器
'account' => 'app\controllers\UserController',
// 用配置数组申明 "article" 控制器
'article' => [
'class' => 'app\controllers\PostController',
'enableCsrfValidation' => false,
],
],
]
每个应用有一个由yii\base\Application::defaultRoute属性指定的默认控制器; 当请求没有指定 路由,该属性值作为路由使用。 对于yii\web\Application网页应用,它的值为 'site'
, 对于 yii\console\Application控制台应用,它的值为 help
, 所以URL为http://hostname/index.php
表示由 site
控制器来处理。
可以在 应用配置 中修改默认控制器,如下所示:
[
'defaultRoute' => 'main',
]
创建操作可简单地在控制器类中定义所谓的 操作方法 来完成,操作方法必须是以action
开头的公有方法。 操作方法的返回值会作为响应数据发送给终端用户,如下代码定义了两个操作 index
和 hello-world
:
namespace app\controllers;
use yii\web\Controller;
class SiteController extends Controller{
public function actionIndex()
{
return $this->render('index');
}
public function actionHelloWorld()
{
return 'Hello World';
}
}
操作通常是用来执行资源的特定操作,因此,操作ID通常为动词,如view
, update
等。
操作ID应仅包含英文小写字母、数字、下划线和中横杠,操作ID中的中横杠用来分隔单词。 例如view
, update2
, comment-post
是真实的操作ID,view?
, Update
不是操作ID.
可通过两种方式创建操作ID,内联操作和独立操作. An inline action is 内联操作在控制器类中定义为方法;独立操作是继承yii\base\Action或它的子类的类。 内联操作容易创建,在无需重用的情况下优先使用; 独立操作相反,主要用于多个控制器重用,或重构为扩展。
内联操作指的是根据我们刚描述的操作方法。
操作方法的名字是根据操作ID遵循如下规则衍生:
action
前缀.例如index
转成 actionIndex
, hello-world
转成 actionHelloWorld
。
注意: 操作方法的名字大小写敏感,如果方法名称为
ActionIndex
不会认为是操作方法, 所以请求index
操作会返回一个异常,也要注意操作方法必须是公有的,私有或者受保护的方法不能定义成内联操作。
因为容易创建,内联操作是最常用的操作,但是如果你计划在不同地方重用相同的操作, 或者你想重新分配一个操作,需要考虑定义它为独立操作。
独立操作通过继承yii\base\Action或它的子类来定义。 例如Yii发布的yii\web\ViewAction和yii\web\ErrorAction都是独立操作。
要使用独立操作,需要通过控制器中覆盖yii\base\Controller::actions()方法在action map中申明,如下例所示:
public function actions(){
return [
// 用类来申明"error" 操作
'error' => 'yii\web\ErrorAction',
// 用配置数组申明 "view" 操作
'view' => [
'class' => 'yii\web\ViewAction',
'viewPrefix' => '',
],
];
}
如上所示, actions()
方法返回键为操作ID、值为对应操作类名或数组configurations 的数组。 和内联操作不同,独立操作ID可包含任意字符,只要在actions()
方法中申明.
为创建一个独立操作类,需要继承yii\base\Action 或它的子类,并实现公有的名称为run()
的方法, run()
方法的角色和操作方法类似,例如:
<?phpnamespace app\components;
use yii\base\Action;
class HelloWorldAction extends Action{
public function run()
{
return "Hello World";
}
}
操作方法或独立操作的run()
方法的返回值非常重要,它表示对应操作结果。
返回值可为 响应 对象,作为响应发送给终端用户。
在上面的例子中,操作结果都为字符串,作为响应数据发送给终端用户,下例显示一个操作通过 返回响应对象(因为yii\web\Controller::redirect()方法返回一个响应对象)可将用户浏览器跳转到新的URL。
public function actionForward(){
// 用户浏览器跳转到 http://example.com
return $this->redirect('http://example.com');
}
内联操作的操作方法和独立操作的 run()
方法可以带参数,称为操作参数。 参数值从请求中获取,对于yii\web\Application网页应用, 每个操作参数的值从$_GET
中获得,参数名作为键; 对于yii\console\Application控制台应用, 操作参数对应命令行参数。
如下例,操作view
(内联操作) 申明了两个参数 $id
和 $version
。
namespace app\controllers;
use yii\web\Controller;
class PostController extends Controller{
public function actionView($id, $version = null)
{
// ...
}
}
操作参数会被不同的参数填入,如下所示:
http://hostname/index.php?r=post/view&id=123
: $id
会填入'123'
,$version
仍为 null 空因为没有version
请求参数;http://hostname/index.php?r=post/view&id=123&version=2
: $id 和
$version 分别填入
'123' 和
'2'`;http://hostname/index.php?r=post/view
: 会抛出yii\web\BadRequestHttpException 异常 因为请求没有提供参数给必须赋值参数$id
;http://hostname/index.php?r=post/view&id[]=123
: 会抛出yii\web\BadRequestHttpException 异常 因为$id
参数收到数字值['123']
而不是字符串.如果想让操作参数接收数组值,需要指定$id为array
,如下所示:
public function actionView(array $id, $version = null){
// ...
}
现在如果请求为 http://hostname/index.php?r=post/view&id[]=123
, 参数 $id
会使用数组值['123']
, 如果请求为http://hostname/index.php?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');
}
}
处理一个请求时,应用主体 会根据请求路由创建一个控制器,控制器经过以下生命周期来完成请求:
beforeAction()
方法;
beforeAction()
会跳过并且操作执行会被取消; action execution will be cancelled.beforeAction()
方法会触发一个 beforeAction
事件,在事件中你可以追加事件处理操作;afterAction()
方法;
afterAction()
方法会触发一个 afterAction
事件,在事件中你可以追加事件处理操作;在设计良好的应用中,控制器很精练,包含的操作代码简短; 如果你的控制器很复杂,通常意味着需要重构,转移一些代码到其他类中。
归纳起来,控制器