1、路由介绍及路由模式
路由可以理解为一种寻径功能模块,比如URL地址里面的index模块怎么才能省略呢,默认的URL地址显得有点长,下面就来说说如何通过路由简化URL访问。ThinkPHP5.0的路由比较灵活,并且不需要强制定义,可以总结归纳为如下三种方式:
1.1、普通模式
关闭路由,完全使用默认的PATH_INFO方式URL:
'url_route_on' => false,
路由关闭后,不会解析任何路由规则,采用默认的PATH_INFO 模式访问URL:
http://serverName/index.php/module/controller/action/param/value/...
但仍然可以通过操作方法的参数绑定、空控制器和空操作等特性实现URL地址的简化。
可以设置url_param_type配置参数来改变pathinfo模式下面的参数获取方式,默认是按名称成对解析,支持按照顺序解析变量,只需要更改为:
// 按照顺序解析变量
'url_param_type' => 1,
1.2、混合模式
开启路由,并使用路由定义+默认PATH_INFO方式的混合:
'url_route_on' => true,
'url_route_must'=> false,
该方式下面,只需要对需要定义路由规则的访问地址定义路由规则,其它的仍然按照第一种普通模式的PATH_INFO模式访问URL。
1.3、强制模式
开启路由,并设置必须定义路由才能访问:
'url_route_on' => true,
'url_route_must' => true,
这种方式下面必须严格给每一个访问地址定义路由规则(包括首页),否则将抛出异常。
首页的路由规则采用/定义即可,例如下面把网站首页路由输出Hello,world!
我们在路由定义文件(application/route.php)里面添加一些路由规则,如下:Route::get('/',function(){
return 'Hello,world!';
});
2、注册路由规则
路由注册可以采用方法动态单个和批量注册,也可以直接定义路由定义文件的方式进行集中注册。
动态注册
路由定义采用\think\Route类的rule方法注册,通常是在应用的路由配置文件application/route.php进行注册,格式是:Route::rule('路由表达式','路由地址','请求类型','路由参数(数组)','变量规则(数组)');
例如注册如下路由规则:use think\Route;
// 注册路由到index模块的News控制器的read操作
Route::rule('news/:id','index/index/news');
我们访问:
http://www.tp.com/news/12
ThinkPHP5.0的路由规则定义是从根目录开始,而不是基于模块名的。
会自动路由到:
http://www.tp.com/index/index/news/id/12
并且原来的访问地址会自动失效。可以在rule方法中指定请求类型,不指定的话默认为任何请求类型,例如:
Route::rule('new/:id','News/update','POST');
表示定义的路由规则在POST请求下才有效。
请求类型包括:
类型描述
GETGET请求
POSTPOST请求
PUTPUT请求
DELETEDELETE请求
*任何请求类型
注意:请求类型参数必须大写。
系统提供了为不同的请求类型定义路由规则的简化方法,例如:Route::get('new/:id','News/read'); // 定义GET请求路由规则
Route::post('new/:id','News/update'); // 定义POST请求路由规则
Route::put('new/:id','News/update'); // 定义PUT请求路由规则
Route::delete('new/:id','News/delete'); // 定义DELETE请求路由规则
Route::any('new/:id','News/read'); // 所有请求都支持的路由规则
如果要定义get和post请求支持的路由规则,也可以用:Route::rule('new/:id','News/read','GET|POST');
我们也可以批量注册路由规则,例如:Route::rule(['new/:id'=>'News/read','blog/:name'=>'Blog/detail']);
Route::get(['new/:id'=>'News/read','blog/:name'=>'Blog/detail']);
Route::post(['new/:id'=>'News/update','blog/:name'=>'Blog/detail']);
注册多个路由规则后,系统会依次遍历注册过的满足请求类型的路由规则,一旦匹配到正确的路由规则后则开始调用控制器的操作方法,后续规则就不再检测。
3、路由表达式
路由表达式统一使字符串定义,采用规则定义的方式。正则路由定义功能已经废除,改由变量规则定义完成。
规则表达式
规则表达式通常包含静态地址和动态地址,或者两种地址的结合,例如下面都属于有效的规则表达式:'/' => 'index', // 首页访问路由
'my' => 'Member/myinfo', // 静态地址路由
'blog/:id' => 'Blog/read', // 静态地址和动态地址结合
'new/:year/:month/:day'=>'News/read', // 静态地址和动态地址结合
':user/:blog_id'=>'Blog/read',// 全动态地址
规则表达式的定义以/为参数分割符(无论你的PATH_INFO分隔符设置是什么,请确保在定义路由规则表达式的时候统一使用/进行URL参数分割)。
每个参数中以“:”开头的参数都表示动态变量,并且会自动绑定到操作方法的对应参数。
演示代码use think\Route;
Route::rule(['news/:id' => 'index/index/news', 't/' => 'index/index/t']);
'mytest/' => 'index/index/mytest'
];
或者完全使用路由表达式return [
'mytest/' => 'index/index/mytest'
];
4、可选定义
支持对路由参数的可选定义,例如:'blog/:year/[:month]'=>'Blog/archive',
[:month]变量用[ ]包含起来后就表示该变量是路由匹配的可选变量。
以上定义路由规则后,下面的URL访问地址都可以被正确的路由匹配:
http://serverName/index.php/blog/2015
http://serverName/index.php/blog/2015/12
采用可选变量定义后,之前需要定义两个或者多个路由规则才能处理的情况可以合并为一个路由规则。
5、完全匹配
规则匹配检测的时候只是对URL从头开始匹配,只要URL地址包含了定义的路由规则就会匹配成功,如果希望完全匹配,可以在路由表达式最后使用$符号,例如:'new/:cate$'=> 'News/category',
http://serverName/index.php/new/info会匹配成功,而http://serverName/index.php/new/info/2 则不会匹配成功。
如果你希望所有的路由定义都是完全匹配的话,可以直接修改配置文件'route_complete_match' => true,
6、额外参数
在路由跳转的时候支持额外传入参数对(额外参数指的是不在URL里面的参数,隐式传入需要的操作中,有时候能够起到一定的安全防护作用,后面我们会提到)。例如:'blog/:id'=>'blog/read?status=1&app_id=5',
上面的路由规则定义中额外参数的传值方式都是等效的。status和app_id参数都是URL里面不存在的,属于隐式传值,当然并不一定需要用到,只是在需要的时候可以使用。