这里讲下继承`\think\Controller` 后我们的控制器获得的超能力
## 控制器初始化
如果你的控制器类继承了`\think\Controller`类的话,可以定义控制器初始化方法`_initialize`,在该控制器的方法调用之前首先执行。
例如:
~~~
namespace app\index\controller;
use think\Controller;
class Index extends Controller
{
public function _initialize()
{
echo 'init<br/>';
}
public function hello()
{
return 'hello';
}
public function data()
{
return 'data';
}
}
~~~
如果访问
[http://localhost/index.php/index/Index/hello](http://localhost/index.php/index/Index/hello)
会输出
~~~
init
hello
~~~
如果访问
[http://localhost/index.php/index/Index/data](http://localhost/index.php/index/Index/data)
会输出
~~~
init
data
~~~
## 前置操作
可以为某个或者某些操作指定前置执行的操作方法,设置 `beforeActionList`属性可以指定某个方法为其他方法的前置操作,数组键名为需要调用的前置方法名,无值的话为当前控制器下所有方法的前置方法。
~~~
['except' => '方法名,方法名']
~~~
表示这些方法不使用前置方法,
~~~
['only' => '方法名,方法名']
~~~
表示只有这些方法使用前置方法。
示例如下:
~~~
namespace app\index\controller;
use think\Controller;
class Index extends Controller
{
protected $beforeActionList = [
'first',
'second' => ['except'=>'hello'],
'three' => ['only'=>'hello,data'],
];
protected function first()
{
echo 'first<br/>';
}
protected function second()
{
echo 'second<br/>';
}
protected function three()
{
echo 'three<br/>';
}
public function hello()
{
return 'hello';
}
public function data()
{
return 'data';
}
}
~~~
访问
~~~
http://localhost/index.php/index/Index/hello
~~~
最后的输出结果是
~~~
first
three
hello
~~~
访问
~~~
http://localhost/index.php/index/Index/data
~~~
的输出结果是:
~~~
first
second
three
data
~~~
## 跳转和重定向
在应用开发中,经常会遇到一些带有提示信息的跳转页面,例如操作成功或者操作错误页面,并且自动跳转到另外一个目标页面。系统的`\think\Controller`类内置了两个跳转方法`success`和`error`,用于页面跳转提示。
使用方法很简单,举例如下:
~~~
namespace app\index\controller;
use think\Controller;
use app\index\model\User;
class Index extends Controller
{
public function index()
{
$User = new User; //实例化User对象
$result = $User->save($data);
if($result){
//设置成功后跳转页面的地址,默认的返回页面是$_SERVER['HTTP_REFERER']
$this->success('新增成功', 'User/list');
} else {
//错误页面的默认跳转页面是返回前一页,通常不需要设置
$this->error('新增失败');
}
}
}
~~~
跳转地址是可选的,success方法的默认跳转地址是`$_SERVER["HTTP_REFERER"]`,error方法的默认跳转地址是`javascript:history.back(-1);`。
> 默认的等待时间都是3秒
`success`和`error`方法都可以对应的模板,默认的设置是两个方法对应的模板都是:
~~~
THINK_PATH . 'tpl/dispatch_jump.tpl'
~~~
我们可以改变默认的模板:
~~~
//默认错误跳转对应的模板文件
'dispatch_error_tmpl' => APP_PATH . 'tpl/dispatch_jump.tpl',
//默认成功跳转对应的模板文件
'dispatch_success_tmpl' => APP_PATH . 'tpl/dispatch_jump.tpl',
~~~
也可以使用项目内部的模板文件
~~~
//默认错误跳转对应的模板文件
'dispatch_error_tmpl' => 'public/error',
//默认成功跳转对应的模板文件
'dispatch_success_tmpl' => 'public/success',
~~~
模板文件可以使用模板标签,并且可以使用下面的模板变量:
| 变量 | 含义 |
| --- | --- |
| $data | 要返回的数据 |
| $msg | 页面提示信息 |
| $code | 返回的code |
| $wait | 跳转等待时间 单位为秒 |
| $url | 跳转页面地址
|
> error方法会自动判断当前请求是否属于`Ajax`请求,如果属于`Ajax`请求则会自动转换为`default_ajax_return`配置的格式返回信息。 success在`Ajax`请求下不返回信息,需要开发者自行处理。
## 重定向
`\think\Controller`类的`redirect`方法可以实现页面的重定向功能。
redirect方法的参数用法和`Url::build`方法的用法一致(参考[URL生成](http://www.kancloud.cn/manual/thinkphp5/118041)部分),例如:
~~~
//重定向到News模块的Category操作
$this->redirect('News/category', ['cate_id' => 2]);
~~~
上面的用法是跳转到News模块的category操作,重定向后会改变当前的URL地址。
或者直接重定向到一个指定的外部URL地址,例如:
~~~
//重定向到指定的URL地址 并且使用302
$this->redirect('http://thinkphp.cn/blog/2',302);
~~~
## 空操作
空操作是指系统在找不到指定的操作方法的时候,会定位到空操作(`_empty`)方法来执行,利用这个机制,我们可以实现错误页面和一些URL的优化。
例如,下面我们用空操作功能来实现一个城市切换的功能。
我们只需要给City控制器类定义一个`_empty` (空操作)方法:
~~~
<?php
namespace app\index\controller;
class City
{
public function _empty($name)
{
//把所有城市的操作解析到city方法
return $this->showCity($name);
}
//注意 showCity方法 本身是 protected 方法
protected function showCity($name)
{
//和$name这个城市相关的处理
return '当前城市' . $name;
}
}
~~~
接下来,我们就可以在浏览器里面输入
~~~
http://serverName/index/city/beijing/
http://serverName/index/city/shanghai/
http://serverName/index/city/shenzhen/
~~~
由于City并没有定义beijing、shanghai或者shenzhen操作方法,因此系统会定位到空操作方法 _empty中去解析,_empty方法的参数就是当前URL里面的操作名,因此会看到依次输出的结果是:
~~~
当前城市:beijing
当前城市:shanghai
当前城市:shenzhen
~~~
空控制器和空操作还可以同时使用,用以完成更加复杂的操作。
空控制器Error是可以定义的
~~~
// 更改默认的空控制器名
'empty_controller' => 'MyError',
~~~
当找不到控制器的时候,就会定位到MyError控制器类进行操作。