本章内容讲解了如何在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地址,而不是到控制器的操作方法,可以直接使用redirect函数重定向,例如:
$New = M('New'); //实例化New对象 $result = $New->add($data); if($result){ //重定向到指定的URL地址 redirect('/New/category/cate_id/2', 5, '页面跳转中...'); }
redirect函数的第一个参数是要跳转的实际URL地址。