快速入门 14：页面跳转和重定向
最后更新于：2022-04-01 00:18:45
# 快速入门（十四）：页面跳转和重定向
本章内容讲解了如何在ThinkPHP中使用页面跳转和重定向功能。
## 页面跳转
系统的`Think\Controller`类内置了两个页面跳转方法error和success，分别用于错误（提示）跳转和成功（提示）跳转。两个方法都会输出一个提示信息页面，然后自动跳转到指定的地址。下面是一个简单的例子：
~~~
$New = M('New'); //实例化New对象
$result = $New->add($data);
if($result){
// 成功后跳转到新闻列表页面
$this->success('新增成功，即将返回列表页面', '/New/index');
} else {
// 错误页面的默认跳转页面是返回前一页，通常不需要设置
$this->error('新增失败');
}
~~~
success和error方法有三个参数，分别是提示信息、跳转地址和跳转页面等待时间（秒），除了第一个参数外其他都是可选的。
**提示信息**：成功或者错误信息字符串。
**跳转地址**：页面跳转地址是可选的，success方法的默认跳转地址是`$_SERVER["HTTP_REFERER"]`，error方法的默认跳转地址是`javascript:history.back(-1);`。
**等待时间**：默认的等待时间success方法是1秒，error方法是3秒。
success和error方法都可以对应的模板，默认两个方法对应的模板是框架自带的跳转模板dispatch_jump.tpl：
~~~
//默认错误跳转对应的模板文件
'TMPL_ACTION_ERROR' => THINK_PATH . 'Tpl/dispatch_jump.tpl',
//默认成功跳转对应的模板文件
'TMPL_ACTION_SUCCESS' => THINK_PATH . 'Tpl/dispatch_jump.tpl',
~~~
success方法默认页面显示如下：
error方法默认页面显示如下：
你可以重新定义跳转模板，通常建议直接放到项目目录下面（下面采用公共模块的模板作为项目统一的跳转模板）：
~~~
//默认错误跳转对应的模板文件
'TMPL_ACTION_ERROR' => 'Common@Public/error',
//默认成功跳转对应的模板文件
'TMPL_ACTION_SUCCESS' => 'Common@Public/success',
~~~
模板文件可以使用模板标签，并且可以使用下面的模板变量：
| 变量 | 含义 |
|-----|-----|
| $message | 页面成功提示信息 |
| $error| 页面错误提示信息 |
| $waitSecond | 跳转等待时间 单位为秒 |
| $jumpUrl | 跳转页面地址 |
## 重定向
如果不需要提示页面，ThinkPHP还可以实现直接重定向操作，`Think\Controller`类提供了redirect方法实现页面的重定向功能。
### 重定向到操作
~~~
redirect('重定向操作地址（一般为[控制器/操作]）','参数（字符串或者数组）','重定向等待时间（秒）','重定向提示信息')
~~~
例如：
~~~
$New = M('New'); //实例化New对象
$result = $New->add($data);
if($result){
// 停留5秒后跳转到New模块的category操作，并且显示页面跳转中字样
$this->redirect('New/category', 'cate_id=2&status=1', 5,'页面跳转中...');
} else {
// 错误页面
$this->redirect('New/error');
}
~~~
可以传入参数和设置重定向的等待时间，甚至给出等待的提示信息：
> 注意：重定向后会改变当前的URL地址。
### 重定向到URL
如果你仅仅是想重定向要一个指定的URL地址，而不是到控制器的操作方法，可以直接使用redirect函数重定向，例如：
~~~
$New = M('New'); //实例化New对象
$result = $New->add($data);
if($result){
//重定向到指定的URL地址
redirect('/New/category/cate_id/2', 5, '页面跳转中...');
}
~~~
> redirect函数的第一个参数是要跳转的实际URL地址。