## 路由参数
路由分组及规则定义支持指定路由参数，这些参数主要完成路由匹配检测以及行为执行。`5.1`版本极大改进了路由参数的用法。
>[danger] 路由参数可以在定义路由规则的时候直接传入（批量），不过`5.1`采用了更加面向对象的方式进行路由参数配置，因此使用方法配置更加清晰。
|参数|说明|方法名|
|---|---|---|
|method|请求类型检测，支持多个请求类型|method|
|ext|URL后缀检测，支持匹配多个后缀|ext|
|deny_ext|URL禁止后缀检测，支持匹配多个后缀|denyExt|
|https|检测是否https请求|https|
|domain|域名检测|domain|
|before|前置行为（检测）|before|
|after|后置行为（执行）|after|
|merge_extra_vars| 合并额外参数|mergeExtraVars|
|complete_match|是否完整匹配路由|completeMatch|
|model|绑定模型|model|
|cache|请求缓存|cache|
|param_depr|路由参数分隔符|depr|
|ajax|Ajax检测|ajax|
|pjax|Pjax检测|pjax|
|response|绑定response_send行为|response|
|validate|绑定验证器类进行数据验证|validate|
|header|设置Response的header信息|header|
|append|追加额外的参数（`5.1.5+`）|append|
|middleware|注册路由中间件（`5.1.6+`）|middleware|
|merge_rule_regex|合并路由规则（`V5.1.6+`）|mergeRuleRegex|
|filter|请求变量过滤（`V5.1.16+`）|filter|
>[danger] `ext`和`deny_ext`参数允许设置为空，分别表示不允许任何后缀以及必须使用后缀访问。
>[info] `V5.1.6+`版本开始，路由的`before`行为参数建议改为使用路由中间件替代。
用法举例：
~~~
Route::get('new/:id','News/read',['ext'=>'html','https'=>true]);
~~~
和使用方法设置（新版推荐的设置方式）等效
~~~
Route::get('new/:id', 'News/read')
->ext('html')
->https();
~~~
显然第二种方式更加直观，而且便于IDE的自动提示。
> 这些路由参数可以混合使用，只要有任何一条参数检查不通过，当前路由就不会生效，继续检测后面的路由规则。
### URL后缀
>[danger] URL后缀如果是全局统一的话，可以在应用配置文件`app.php`中设置`url_html_suffix`参数，如果当前访问的URL地址中的URL后缀是允许的伪静态后缀，那么后缀本身是不会被作为参数值传入的。
不同参数设置的区别如下：
配置值|描述
---|---|---
`false`|禁止伪静态访问
空字符串|允许任意伪静态后缀
`html`|只允许设置的伪静态后缀
~~~
// 定义GET请求路由规则 并设置URL后缀为html的时候有效
Route::get('new/:id', 'News/read')
->ext('html');
~~~
支持匹配多个后缀，例如：
~~~php
Route::get('new/:id', 'News/read')
->ext('shtml|html');
~~~
> 如果`ext`方法不传入任何值，表示不允许使用任何后缀访问。
可以设置禁止访问的URL后缀，例如：
~~~
// 定义GET请求路由规则 并设置禁止URL后缀为png、jpg和gif的访问
Route::get('new/:id', 'News/read')
->denyExt('jpg|png|gif');
~~~
> 如果`denyExt`方法不传入任何值，表示必须使用后缀访问。
### 域名检测
支持使用完整域名或者子域名进行检测，例如：
~~~
// 完整域名检测 只在news.thinkphp.cn访问时路由有效
Route::get('new/:id', 'News/read')
->domain('news.thinkphp.cn');
// 子域名检测
Route::get('new/:id', 'News/read')
->domain('news');
~~~
> 如果需要给子域名定义批量的路由规则，建议使用`domain`方法进行路由定义。
### HTTPS检测
支持检测当前是否HTTPS访问
~~~
// 必须使用HTTPS访问
Route::get('new/:id', 'News/read')
->https();
// 必须使用HTTP访问
Route::get('new/:id', 'News/read')
->https(false);
~~~
### 请求变量检测（`V5.1.16+`）
可以在匹配URL地址之外，额外检查请求变量是否匹配，只有指定的请求变量也一致的情况下才能匹配该路由。
~~~
// 检查type变量
Route::post('new/:id', 'News/save')
->filter('type', 1);
// 检查多个请求变量
Route::post('new/:id', 'News/save')
->filter([ 'type' => 1,'status'=> 1 ]);
~~~
### 前置行为检测
支持使用行为对路由进行检测是否匹配，如果行为方法返回`false`表示当前路由规则无效。
~~~
Route::get('user/:id', 'index/User/read')
->before(['\app\index\behavior\UserCheck']);
~~~
行为类定义如下：
~~~
<?php
namespace app\index\behavior;
class UserCheck
{
public function run()
{
if ('user/0' == request()->url()) {
return false;
}
}
}
~~~
可以同时使用多个行为进行检测，并且支持使用闭包。
>[danger] 因为前置行为的特殊性，在路由参数的有效性检查后，无论是否最终匹配该路由，都会进行前置行为检查（路由分组的话 会在匹配该分组后再检查）。
### 后置行为执行
>[danger] `V5.1.6+`版本开始建议使用中间件替代路由后置行为。
可以为某个路由或者某个分组路由定义后置行为执行，表示当路由匹配成功后，执行的行为，例如：
~~~
Route::get('user/:id', 'User/read')
->after(['\app\index\behavior\ReadInfo']);
~~~
其中`ReadInfo`行为类定义如下：
~~~
<?php
namespace app\index\behavior;
use app\index\model\User;
class ReadInfo
{
public function run()
{
$id = request()->route('id');
app()->user = User::get($id);
}
}
~~~
如果成功匹配到`new/:id`路由后，就会执行行为类的`run`方法，参数是路由地址，可以动态改变。同样，后置行为也支持传入闭包。
### 合并额外参数
通常用于完整匹配的情况，如果有额外的参数则合并作为变量值，例如：
~~~
Route::get('new/:name$', 'News/read')
->mergeExtraVars();
~~~
~~~
http://serverName/new/thinkphp/hello
~~~
会被匹配到，并且`name`变量的值为 `thinkphp/hello`。
### 路由绑定模型
路由规则和分组支持绑定模型数据，例如：
~~~php
Route::get('hello/:id', 'index/index/hello')
->model('id', '\app\index\model\User');
~~~
会自动给当前路由绑定 `id`为 当前路由变量值的`User`模型数据。
如果你的模型绑定使用的是`id`作为查询条件的话，还可以简化成下面的方式
~~~php
Route::get('hello/:id', 'index/index/hello')
->model('\app\index\model\User');
~~~
默认情况下，如果没有查询到模型数据，则会抛出异常，如果不希望抛出异常，可以使用
~~~php
Route::rule('hello/:id', 'index/index/hello')
->model('id', '\app\index\model\User', false);
~~~
可以定义模型数据的查询条件，例如：
~~~
Route::rule('hello/:name/:id', 'index/index/hello')
->model('id&name', '\app\index\model\User');
~~~
表示查询`id`和`name`的值等于当前路由变量的模型数据。
也可以使用闭包来自定义返回需要的模型对象
~~~
Route::rule('hello/:id', 'index/index/hello')
->model(function ($id) {
$model = new \app\index\model\User;
return $model->where('id', $id)->find();
});
~~~
闭包函数的参数就是当前请求的URL变量信息。
> 绑定的模型可以直接在控制器的架构方法或者操作方法中自动注入，具体可以参考请求章节的依赖注入。
### 缓存路由请求
可以对当前的路由请求进行缓存处理，例如：
~~~
Route::get('new/:name$', 'News/read')
->cache(3600);
~~~
表示对当前路由请求缓存3600秒，更多内容可以参考[请求缓存](353992)一节。
## 设置Header信息
~~~
Route::get('new/:name$', 'News/read')
->header('Access-Control-Allow-Origin','*');
~~~
> header方法支持多次调用。
或者使用数组方式批量设置
~~~
Route::get('new/:name$', 'News/read')
->header([
'Access-Control-Allow-Origin'=>'*',
'Access-Control-Allow-Methods' => 'GET, POST, PATCH, PUT, DELETE',
]);
~~~
当路由匹配后，会自动设置本次请求的Response响应对象的Header信息。
## 响应输出设置
可以调用`response`方法给路由或者分组绑定响应输出参数，例如：
~~~
Route::get('hello/:id', 'index/index/hello')->response([
'\app\index\behavior\Json',
]);
~~~
行为类定义如下：
~~~
namespace app\index\behavior;
class Json
{
public function run($response)
{
// 调用Response类的方法进行设置
$response->contentType('application/json');
}
}
~~~
如果不希望使用行为，可以直接使用闭包
~~~
Route::get('hello/:id', 'index/index/hello')->response(function($response){
$response->contentType('application/json');
});
~~~
如果要给某个路由返回单独的响应对象，也可以使用
~~~
Route::get('hello/:id', function () {
return json('hello,world!');
});
~~~
## 全局路由参数
可以直接进行全局的路由参数设置，例如在路由定义文件中使用
~~~
Route::option('ext','html')->option('cache', 600);
~~~
表示全局路由都使用html后缀以及600秒的请求缓存。
## 动态参数
如果你需要额外自定义一些路由参数，可以使用下面的方式：
~~~
Route::get('new/:name$', 'News/read')
->option('rule','admin');
~~~
或者使用动态方法
~~~
Route::get('new/:name$', 'News/read')
->rule('admin');
~~~
在后续的路由行为后可以调用该路由的`rule`参数来进行权限检查。
## 路由中间件（`V5.1.6+`）
从`5.1.6+`版本开始，可以使用路由中间件，注册方式如下：
~~~
Route::rule('hello/:name','hello')
->middleware('Auth');
~~~
或者对路由分组注册中间件
~~~
Route::group('hello', function(){
Route::rule('hello/:name','hello');
})->middleware('Auth');
~~~
如果需要传入额外参数给中间件，可以使用
~~~
Route::rule('hello/:name','hello')
->middleware('Auth:admin');
~~~
如果使用的是常量方式定义，可以在第二个参数传入中间件参数。
~~~
Route::rule('hello/:name','hello')
->middleware(Auth::class, 'admin');
~~~
如果需要定义多个中间件，使用数组方式
~~~
Route::rule('hello/:name','hello')
->middleware([Auth::class, 'Check']);
~~~
可以统一传入同一个额外参数
~~~
Route::rule('hello/:name','hello')
->middleware([Auth::class, 'Check'], 'admin');
~~~
或者单独指定中间件参数。
~~~
Route::rule('hello/:name','hello')
->middleware(['Auth:admin', 'Check:editor']);
~~~
更多中间件的用法参考架构章节的[中间件](中间件.md)内容。
- 序言
- 基础
- 安装
- 开发规范
- 目录结构
- 配置
- 架构
- 架构总览
- 入口文件
- URL访问
- 模块设计
- 命名空间
- 容器和依赖注入
- Facade
- 钩子和行为
- 中间件
- 路由
- 路由定义
- 变量规则
- 路由地址
- 闭包支持
- 路由参数
- 路由缓存
- 跨域请求
- 注解路由
- 路由分组
- MISS路由
- 资源路由
- 快捷路由
- 路由别名
- 路由绑定
- 域名路由
- URL生成
- 控制器
- 控制器定义
- 前置操作
- 跳转和重定向
- 空操作和空控制器
- 分层控制器
- 资源控制器
- 控制器中间件
- 请求
- 请求对象
- 请求信息
- 输入变量
- 请求类型
- HTTP头信息
- 伪静态
- 参数绑定
- 请求缓存
- 响应
- 响应输出
- 响应参数
- 重定向
- 文件下载
- 数据库
- 连接数据库
- 查询构造器
- 查询数据
- 添加数据
- 更新数据
- 删除数据
- 查询表达式
- 链式操作
- where
- table
- alias
- field
- strict
- limit
- page
- order
- group
- having
- join
- union
- distinct
- lock
- cache
- comment
- fetchSql
- force
- partition
- failException
- sequence
- 聚合查询
- 时间查询
- 高级查询
- 视图查询
- JSON字段
- 子查询
- 原生查询
- 查询事件
- 获取器
- 事务操作
- 监听SQL
- 存储过程
- 数据集
- 分布式数据库
- 模型
- 定义
- 新增
- 更新
- 删除
- 查询
- JSON字段
- 获取器
- 修改器
- 搜索器
- 数据集
- 自动时间戳
- 只读字段
- 软删除
- 类型转换
- 数据完成
- 查询范围
- 模型输出
- 模型事件
- 模型关联
- 一对一关联
- 一对多关联
- 远程一对多
- 多对多关联
- 多态关联
- 关联预载入
- 关联统计
- 关联输出
- 视图
- 视图渲染
- 视图赋值
- 视图过滤
- 模板引擎
- 模板
- 变量输出
- 使用函数
- 运算符
- 原样输出
- 模板注释
- 模板布局
- 模板继承
- 包含文件
- 输出替换
- 标签库
- 内置标签
- 循环标签
- 比较标签
- 条件判断
- 资源文件加载
- 标签嵌套
- 原生PHP
- 定义标签
- 标签扩展
- 错误和日志
- 异常处理
- 日志处理
- 调试
- 调试模式
- Trace调试
- 性能调试
- SQL调试
- 变量调试
- 远程调试
- 验证
- 验证器
- 验证规则
- 错误信息
- 验证场景
- 路由验证
- 内置规则
- 独立验证
- 静态调用
- 表单令牌
- 杂项
- 缓存
- Session
- Cookie
- 多语言
- 分页
- 上传
- 命令行
- 启动内置服务器
- 查看版本
- 自动生成目录结构
- 创建类库文件
- 生成类库映射文件
- 清除缓存文件
- 生成配置缓存文件
- 生成数据表字段缓存
- 生成路由映射缓存
- 输出路由定义
- 自定义指令
- 扩展库
- 验证码
- 图像处理
- Time
- 数据库迁移工具
- Swoole
- Workerman
- MongoDb
- 单元测试
- 安全和性能
- 安全建议
- 优化建议
- 附录
- 助手函数
- 升级指导
- 更新日志