ThinkPHP5文档——路由

一、路由模式

ThinkPHP5.0的路由比较灵活，并且不需要强制定义，可以总结归纳为如下三种方式：

普通模式

关闭路由，完全使用默认的PATH_INFO方式URL：

'url_route_on'  =>  false,
1

路由关闭后，不会解析任何路由规则，采用默认的PATH_INFO 模式访问URL：

http://serverName/index.php/module/controller/action/param/value/...
1

可以设置url_param_type配置参数来改变pathinfo模式下面的参数获取方式，默认是按名称成对解析，支持按照顺序解析变量，只需要更改为：

// URL参数方式 0 按名称成对解析 1 按顺序解析
'url_param_type'         => 1
1
2

混合模式

开启路由，并使用路由定义+默认PATH_INFO方式的混合：

// 是否开启路由
'url_route_on'           => true,
// 是否强制使用路由
'url_route_must'         => false,
1
2
3
4

该方式下面，只需要对需要定义路由规则的访问地址定义路由规则，其它的仍然按照第一种普通模式的PATH_INFO模式访问URL。

强制模式

开启路由，并设置必须定义路由才能访问：

'url_route_on'  		=>  true,
'url_route_must'		=>  true,
1
2

这种方式下面必须严格给每一个访问地址定义路由规则（包括首页），否则将抛出异常。

首页的路由规则采用/定义即可，例如下面把网站首页路由输出Hello,world!

Route::get('/',function(){
    return 'Hello,world!';
});
1
2
3

二、路由定义

注册路由规则

路由注册可以采用方法动态单个和批量注册，也可以直接定义路由定义文件的方式进行集中注册。

动态注册

路由定义采用\think\Route类的rule方法注册，通常是在应用的路由配置文件application/route.php
进行注册，格式是：

Route::rule('路由表达式','路由地址','请求类型','路由参数（数组）','变量规则（数组）');

use think\Route;
// 注册路由到index模块的News控制器的read操作
Route::rule('new/:id','index/News/read');

//访问    http://serverName/new/5
// 会自动路由到：http://serverName/index/news/read/id/5
1
2
3
4
5
6
7
8

ThinkPHP5.0的路由规则定义是从根目录开始，而不是基于模块名的。
路由表达式（第一个参数）支持定义命名标识，例如：

// 定义new路由命名标识
Route::rule(['new','new/:id'],'index/News/read');
1
2

注意，路由命名标识必须唯一，定义后可以用于URL的快速生成。

可以在rule方法中指定请求类型，不指定的话默认为任何请求类型，例如：

// 表示定义的路由规则在POST请求下才有效。  注意：请求类型参数必须大写。
Route::rule('new/:id','News/update','POST');
1
2

请求类型包括：

补充：POST请求和GET请求的区别：

  get:  通过请求头提交到后台，参数放在URL后面：只能向后台提交文本数据；
          对长度有限制；
          数据不安全；
      	  优势：效率高，有缓存（对静态资源友好），对网速要求较低
  post: 参数通过请求体提交到后台；既能提交文本数据，又能提交二进制数据。
          理论上对长度没有限制；
          相对安全；
          效率相对较低；
1
2
3
4
5
6
7
8

系统提供了为不同的请求类型定义路由规则的简化方法，例如：

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'); // 所有请求都支持的路由规则
1
2
3
4
5

如果要定义get和post请求支持的路由规则，也可以用：

Route::rule('new/:id','News/read','GET|POST');
1

我们也可以批量注册路由规则，例如：

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']);
1
2
3

注册多个路由规则后，系统会依次遍历注册过的满足请求类型的路由规则，一旦匹配到正确的路由规则后则开始调用控制器的操作方法，后续规则就不再检测。

路由表达式

路由表达式统一使字符串定义，采用规则定义的方式。
正则路由定义功能已经废除，改由变量规则定义完成。

规则表达式

规则表达式通常包含静态地址和动态地址，或者两种地址的结合，例如下面都属于有效的规则表达式：

'/' => 'index', // 首页访问路由
'my'        =>  'Member/myinfo', // 静态地址路由
'blog/:id'  =>  'Blog/read', // 静态地址和动态地址结合
'new/:year/:month/:day'=>'News/read', // 静态地址和动态地址结合
':user/:blog_id'=>'Blog/read',// 全动态地址
1
2
3
4
5

规则表达式的定义以/为参数分割符,每个参数中以“:”开头的参数都表示动态变量，并且会自动绑定到操作方法的对应参数。

支持对路由参数的可选定义，例如：

'blog/:year/[:month]'=>'Blog/archive',
[:month]变量用[ ]包含起来后就表示该变量是路由匹配的可选变量。
可选参数只能放到路由规则的最后，如果在中间使用了可选参数的话，后面的变量都会变成可选参数。

以上定义路由规则后，下面的URL访问地址都可以被正确的路由匹配：
http://serverName/index.php/blog/2015
http://serverName/index.php/blog/2015/12
1
2
3
4
5
6
7

完全匹配

默认是从头开始匹配的，只要URL地址包含了定义的路由规则就会匹配成功，如果希望完全匹配，可以在路由表达式最后使用$符号，例如：

'new/:cate$'=> 'News/category',

http://serverName/index.php/new/info		这个会匹配成功
http://serverName/index.php/new/info/2 		这个则不会

若采用 'new/:cate'=> 'News/category', 则以上两种都会匹配成功
1
2
3
4
5
6

若希望路由都是完全匹配的，可以配置：

// 开启路由定义的全局完全匹配
'route_complete_match'  =>  true,
1
2

当开启完全匹配之后，若个别不需要，则可通过路由参数覆盖其配置：

Route::rule('new/:id','News/read','GET|POST',['complete_match' => false]);
1

补充：正则表达式

1.一种语言，语法：定义字符串的匹配模式，可以用来判断指定的具体字符串是否符合匹配模式。
​  2.语法通则：
​         `)^:匹配字符串的开头位置
​           $:匹配字符串的结尾
​         2)[]:表示匹配指定字符集中的一位字符。
​         3){}:匹配次数。
​                 {m}:匹配m次
​                 {m,n}:匹配m次到n次
​                 {m,}:表示匹配m次或更多次
​          4)特殊字符：
​             \d:匹配一位数字，相当于[0-9]
​             \D:匹配一位非数字
​             \w:匹配所有的字符，包括字母，数字，下划线
​             \W:匹配非字符，除了字母、数字、下划线之外的字符。
​             *:匹配0次或者多次，相当于{0,}
​             +:匹配1次或者多次，相当于{1,}
​             ?:匹配0次或者一次，相当于{0,1}

​			/s：匹配任意一个空白

​			/S:匹配任意非空
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

额外参数

'blog/:id'=>'blog/read?status=1&app_id=5',
1

status和app_id参数都是URL里面不存在的，属于隐式传值。

三、批量注册

批量注册路由规则可以使用两种方式，包括方法注册和路由配置定义。