thinkphp5 router.php,路由定义 · ThinkPHP5.0完全开发手册 · 看云

## 注册路由规则

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

### 动态注册

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

>[info] #### Route::rule('路由表达式','路由地址','请求类型','路由参数(数组)','变量规则(数组)');

例如注册如下路由规则：

~~~

use think\Route;

// 注册路由到index模块的News控制器的read操作

Route::rule('new/:id','index/News/read');

~~~

我们访问：

~~~

http://serverName/new/5

~~~

> ThinkPHP5.0的路由规则定义是从根目录开始，而不是基于模块名的。

会自动路由到：

~~~

http://serverName/index/news/read/id/5

~~~

并且原来的访问地址会自动失效。

路由表达式(第一个参数)支持定义命名标识，例如：

~~~

// 定义new路由命名标识

Route::rule(['new','new/:id'],'index/News/read');

~~~

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

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

~~~

Route::rule('new/:id','News/update','POST');

~~~

表示定义的路由规则在POST请求下才有效。

请求类型包括：

|类型|描述|

|---|---|

|GET| GET请求|

|POST| POST请求|

|PUT| PUT请求|

|DELETE |DELETE请求|

|* |任何请求类型|

> 注意：请求类型参数必须大写。

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

~~~

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

~~~

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

## 路由表达式

路由表达式统一使字符串定义，采用规则定义的方式。

>[danger] 正则路由定义功能已经废除，改由变量规则定义完成。

### 规则表达式

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

~~~

'/' => 'index', // 首页访问路由

'my' => 'Member/myinfo', // 静态地址路由

'blog/:id' => 'Blog/read', // 静态地址和动态地址结合

'new/:year/:month/:day'=>'News/read', // 静态地址和动态地址结合

':user/:blog_id'=>'Blog/read',// 全动态地址

~~~

规则表达式的定义以`/`为参数分割符(无论你的PATH_INFO分隔符设置是什么，请确保在定义路由规则表达式的时候统一使用`/`进行URL参数分割)。

每个参数中以“:”开头的参数都表示动态变量，并且会自动绑定到操作方法的对应参数。

### 可选定义

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

~~~

'blog/:year/[:month]'=>'Blog/archive',

~~~

`[:month]`变量用`[ ]`包含起来后就表示该变量是路由匹配的可选变量。

以上定义路由规则后，下面的URL访问地址都可以被正确的路由匹配：

~~~

http://serverName/index.php/blog/2015

http://serverName/index.php/blog/2015/12

~~~

采用可选变量定义后，之前需要定义两个或者多个路由规则才能处理的情况可以合并为一个路由规则。

> 可选参数只能放到路由规则的最后，如果在中间使用了可选参数的话，后面的变量都会变成可选参数。

### 完全匹配

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

~~~

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

~~~

~~~

http://serverName/index.php/new/info

~~~

会匹配成功,而

~~~

http://serverName/index.php/new/info/2

~~~

则不会匹配成功。

如果是采用

~~~

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

~~~

方式定义的话，则两种方式的URL访问都可以匹配成功。

如果你希望所有的路由定义都是完全匹配的话，可以直接配置

~~~

// 开启路由定义的全局完全匹配

'route_complete_match' => true,

~~~

当开启全局完全匹配的时候，如果个别路由不需要使用完整匹配，可以添加路由参数覆盖定义：

~~~

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

~~~

## 额外参数

在路由跳转的时候支持额外传入参数对(额外参数指的是不在URL里面的参数，隐式传入需要的操作中，有时候能够起到一定的安全防护作用，后面我们会提到)。例如：

~~~

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

~~~

上面的路由规则定义中额外参数的传值方式都是等效的。`status`和`app_id`参数都是URL里面不存在的，属于隐式传值，当然并不一定需要用到，只是在需要的时候可以使用。