所有的路由规则是不支持普通URL参数的,必须是PATHINFO地址。
路由定义文件不一定是route.php,事实上可以是任何文件名。
如果你开启了路由强制模式,那么未定义的路由访问将会抛出异常。
统一使用路由方法注册路由而不要再使用返回数组配置,路由规则不区分大小写,因此统一使用小写定义。
尽量避免使用闭包定义路由规则(注意不要和分组路由的闭包定义搞混淆),优先使用资源路由定义,在不适用资源路由的情况下也要多使用路由分组,不仅可以简化路由定义和提高性能,也更加规范。
大部分情况下,建议开启全局路由完整匹配,个别不需要完整匹配的路由规则可以在定义的时候使用completeMatch方法单独关闭。
Route::get('user/
如果需要使用伪静态地址,可以全局配置URL访问后缀,对于个别特殊后缀的路由可以在路由定义的时候单独指定。
Route::get('hello/
明确你的路由变量规则,不要忽略路由变量的规则定义,避免可能的解析错误。例如,当你的路由变量中使用了小数点或者斜线的情况,必须严格定义你的变量规则。
优先在路由定义的时候指定中间件、进行数据验证和请求缓存等操作,原则就是在路由里面能做的事情尽量提前不要等到控制器里面才执行。
为了方便查看当前项目定义的路由规则,可以使用下面的指令生成路由规则查看文件。
php think route:list
然后可以在runtime目录下的route_list.php可以查看所有的路由列表。
关闭路由
如果某个应用需要关闭路由功能,可以在应用的app.php配置文件中定义
'with_route' => false,
但需要注意的是,即使关闭路由,也会走默认路由(即控制器/操作)解析,因此路由全局中间件仍然有效。
明确定义请求类型
尽量明确定义路由的请求类型,提高路由解析的效率。
推荐使用:
Route::get('hello/:name', 'index/hello');
替代:
Route::rule('hello/:name', 'index/hello');
不需要添加开头斜线
除了首页外,其它路由规则定义不需要添加开头的斜线。
推荐使用:
Route::get('hello/:name', 'index/hello');
不建议使用:
Route::get('/hello/:name', 'index/hello');
除非是首页路由
Route::get('/', 'index/index');
或者直接访问分组名的情况
Route::group('blog', function() {
Route::get('/', 'index/blog');
Route::get(':id$', 'blog/read');
Route::get(':id/edit$', 'blog/edit');
});
多使用路由分组
可能的情况下,尽可能多使用路由分组。可以充分利用分组的匹配机制提高路由解析性能。
推荐使用
Route::group('blog', function() {
Route::get(':id$', 'blog/read');
Route::get(':id/edit$', 'blog/edit');
});
不建议使用
Route::get('blog/:id$', 'blog/read');
Route::get('blog/:id/edit$', 'blog/edit');
路由分组传入额外参数
可以统一给分组路由传入额外的参数
Route::group('blog', function() {
Route::get(':id$', 'blog/read');
Route::get(':id/edit$', 'blog/edit');
})->ext('html')
->pattern(['id' => '\d+'])
->append(['group_id'=>1]);
上面的分组路由统一传入了group_id参数,该参数的值可以通过Request类的param方法获取。
路由变量定义规范
对于新版的路由变量定义来说,不再区分普通变量和组合变量,哪怕你使用:name方式定义,内部也会统一转换成
Route::group('blog', function() {
Route::get('
Route::get('
});
尽量明确定义路由变量的规则
Route::group('blog', function() {
Route::get('
Route::get('
})->pattern(['id' => '\d+']);
路由变量规则采用正则表达式方式定义,但无需在开头添加^或者在最后添加$,也无需使用模式修饰符,系统会自动添加。
不能使用$_GET方法或者Request类的get方法获取路由变量,而应该使用param方法或者参数绑定。
如果开启了路由合并解析的话,分组下面的多个路由规则是通过一次解析匹配完成的,如果路由规则较多性能会有大幅提升。
变量分隔符
你可以很随意的使用路由变量分隔符,只要注意不要和你的变量规则冲突。
Route::get('item/
->pattern(['date'=>'\d{8}','name'=>'\w+','id'=>'\d+']);
默认路由变量规则
默认情况下,如果你没有定义变量规则,则使用\w+作为变量规则
Route::get('hello/
其实等同于
Route::get('hello/
'name' => '\w+',
]);
如果你希望改变默认的路由变量规则,可以在应用配置文件中设置
// 默认的路由变量规则
'default_routepattern' => '[a-z0-9-\.]+',
路由完全匹配
默认的路由规则只是匹配URL地址的开头是否和定义的路由匹配
所以
Route::get('hello/:name', 'index/hello');
可以匹配下面的URL地址
hello/think
hello/think/thinkphp
hello/think/thinkphp/demo
但如果添加了路由完全匹配后
Route::get('hello/:name$', 'index/hello');
上面的三个URL地址中就只会匹配
hello/think
建议你开启全局路由完全匹配
// 路由完全匹配
'route_complete_match' => true,
如果有个别路由仍然希望不要完全匹配,你可以使用
Route::get('hello/:name', 'index/hello')
->completeMatch(false);
关闭当前路由规则(或者路由分组)的完整匹配。
定义路由标识
路由标识的作用只是用于URL地址生成,而且默认会使用当前的路由地址作为路由标识。
Route::get('hello/:name', 'index/hello');
echo url('index/hello', ['name' => 'think']);
如果指定了路由标识的话,url方法的用法就需要调整为:
Route::get('hello/:name', 'index/hello')->name('hello');
echo url('hello', ['name' => 'think']);
如果你希望简化URL地址的生成调用,可以在项目规范中强制统一规范,而不要使用URL地址这种默认标识,使用路由标识的优势是即使路由地址发生了变化,也无需改变url方法的代码。
用方法定义路由参数
出于语义化考虑,路由参数建议使用方法而不是参数。
推荐使用(支持IDE)
Route::get('new/:id', 'News/read')
->ext('html')
->https();
不建议使用:
Route::get('new/:id','News/read')->option(['ext'=>'html','https'=>true]);
MISS路由
一旦你设置了全局的MISS路由,相当于开启了强制路由模式。
Route::miss('public/miss');
MISS路由可以针对不同路由分组(或者域名)设置,也可以针对不同的请求类型设置,
Route::group('blog', function() {
Route::get(':name$', 'blog/read');
...
Route::miss('blog/error','get');
Route::miss('blog/noAuth','post');
});
Route::group('user', function() {
Route::get(':id', 'user/info');
...
Route::miss('user/error');
});
发表评论