ThinkPHP5文档——路由

文章目录

  • 一、路由模式
    • 普通模式
    • 混合模式
    • 强制模式
  • 二、路由定义
    • 注册路由规则
      • 动态注册
        • 补充:POST请求和GET请求的区别:
      • 路由表达式
        • 规则表达式
        • 支持对路由参数的可选定义,例如:
      • 完全匹配
        • 补充:正则表达式
      • 额外参数
  • 三、批量注册

一、路由模式

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

普通模式

关闭路由,完全使用默认的PATH_INFO方式URL:

'url_route_on'  =>  false,

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

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

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

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

混合模式

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

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

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

强制模式

开启路由,并设置必须定义路由才能访问:

'url_route_on'  		=>  true,
'url_route_must'		=>  true,

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

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

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

二、路由定义

注册路由规则

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

动态注册

路由定义采用\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

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

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

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

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

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

请求类型包括:

类型 描述
GET GET请求
POST POST请求
PUT PUT请求
DELETE DELETE请求
* 任何请求

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

  get:  通过请求头提交到后台,参数放在URL后面:只能向后台提交文本数据;
          对长度有限制;
          数据不安全;
      	  优势:效率高,有缓存(对静态资源友好),对网速要求较低
  post: 参数通过请求体提交到后台;既能提交文本数据,又能提交二进制数据。
          理论上对长度没有限制;
          相对安全;
          效率相对较低;

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

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

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

路由表达式

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

规则表达式

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

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

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

支持对路由参数的可选定义,例如:

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

以上定义路由规则后,下面的URL访问地址都可以被正确的路由匹配:
http://serverName/index.php/blog/2015
http://serverName/index.php/blog/2015/12

完全匹配

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

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

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

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

若希望路由都是完全匹配的,可以配置:

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

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

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

补充:正则表达式

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:匹配任意非空

额外参数

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

statusapp_id参数都是URL里面不存在的,属于隐式传值。

三、批量注册

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

你可能感兴趣的:(#,ThinkPHP5.0,Thinkphp5,thinkphp路由)