路由分组及规则定义支持指定路由参数,这些参数主要完成路由匹配检测以及后续行为。
路由参数可以在定义路由规则的时候直接传入(批量),推荐使用方法配置更加清晰。
| 参数 | 说明 | 方法名 | 
|---|---|---|
| ext | URL后缀检测,支持匹配多个后缀 | ext | 
| deny_ext | URL禁止后缀检测,支持匹配多个后缀 | denyExt | 
| https | 检测是否https请求 | https | 
| domain | 域名检测 | domain | 
| complete_match | 是否完整匹配路由 | completeMatch | 
| model | 绑定模型 | model | 
| cache | 请求缓存 | cache | 
| ajax | Ajax检测 | ajax | 
| pjax | Pjax检测 | pjax | 
| json | JSON检测 | json | 
| validate | 绑定验证器类进行数据验证 | validate | 
| append | 追加额外的参数 | append | 
| middleware | 注册路由中间件 | middleware | 
| filter | 请求变量过滤 | filter | 
| match | 路由闭包检测( V6.0.12+) | match | 
用法举例:
Route::get('new/:id', 'News/read')    ->ext('html')    ->https();这些路由参数可以混合使用,只要有任何一条参数检查不通过,当前路由就不会生效,继续检测后面的路由规则。
如果你需要批量设置路由参数,也可以使用option方法。
Route::get('new/:id', 'News/read')    ->option([        'ext'   => 'html',        'https' => true    ]);URL后缀如果是全局统一的话,可以在路由配置文件中设置
url_html_suffix参数,如果当前访问的URL地址中的URL后缀是允许的伪静态后缀,那么后缀本身是不会被作为参数值传入的。
不同参数设置的区别如下:
| 配置值 | 描述 | 
|---|---|
| false | 禁止伪静态访问 | 
| 空字符串 | 允许任意伪静态后缀 | 
| html | 只允许设置的伪静态后缀 | 
| html|htm | 允许多个伪静态后缀 | 
// 定义GET请求路由规则 并设置URL后缀为html的时候有效Route::get('new/:id', 'News/read')    ->ext('html');支持匹配多个后缀,例如:
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();AJAX/PJAX/JSON检测可以检测当前是否为AJAX/PJAX/JSON请求。
// 必须是JSON请求访问Route::get('new/:id', 'News/read')    ->json();可以在匹配路由地址之外,额外检查请求变量是否匹配,只有指定的请求变量也一致的情况下才能匹配该路由。
// 检查type变量Route::post('new/:id', 'News/save')    ->filter('type', 1);// 检查多个请求变量Route::post('new/:id', 'News/save')    ->filter([ 'type' => 1,'status'=> 1 ]);V6.0.12+开始,可以通过闭包来检测当前路由或分组是否匹配
// 闭包检测Route::get('new/:id', 'News/read')    ->match(function(Rule $rule,Request $request) {        // 如果返回false 则视为不匹配        return false;    });可以在定义路由的时候隐式追加额外的参数,这些参数不会出现在URL地址中。
Route::get('blog/:id', 'Blog/read')    ->append(['app_id' => 1, 'status' => 1]);在路由请求的时候会同时传入app_id和status两个参数。
路由规则和分组支持绑定模型数据,例如:
Route::get('hello/:id', 'index/hello')    ->model('id', '\app\index\model\User');会自动给当前路由绑定 id为 当前路由变量值的User模型数据。
如果你的模型绑定使用的是id作为查询条件的话,还可以简化成下面的方式
Route::get('hello/:id', 'index/hello')    ->model('\app\index\model\User');默认情况下,如果没有查询到模型数据,则会抛出异常,如果不希望抛出异常,可以使用
Route::rule('hello/:id', 'index/hello')    ->model('id', '\app\index\model\User', false);可以定义模型数据的查询条件,例如:
Route::rule('hello/:name/:id', 'index/hello')    ->model('id&name', '\app\index\model\User');表示查询id和name的值等于当前路由变量的模型数据。
也可以使用闭包来自定义返回需要的模型对象
Route::rule('hello/:id', '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秒,更多内容可以参考请求缓存一节。
如果你需要额外自定义一些路由参数,可以使用下面的方式:
Route::get('new/:name$', 'News/read')    ->option('rule','admin');或者使用动态方法
Route::get('new/:name$', 'News/read')    ->rule('admin');在后续的路由行为后可以调用该路由的rule参数来进行权限检查。