牛骨文教育服务平台(让学习变的简单)

路由参数

路由参数

路由参数是指可以设置一些路由匹配的条件参数,主要用于验证当前的路由规则是否有效,主要包括:

参数说明
method请求类型检测,支持多个请求类型
extURL后缀检测,支持匹配多个后缀
deny_extURL禁止后缀检测,支持匹配多个后缀
https检测是否https请求
domain域名检测
before_behavior前置行为(检测)
after_behavior后置行为(执行)
callback自定义检测方法
merge_extra_vars合并额外参数
bind_model绑定模型(V5.0.1+
cache请求缓存(V5.0.1+
param_depr路由参数分隔符(V5.0.2+
ajaxAjax检测(V5.0.2+
pjaxPjax检测(V5.0.2+

V5.0.3+版本对ajax/pjax/https条件支持false

这些路由参数可以混合使用,只要有任何一条参数检查不通过,当前路由就不会生效,继续检测后面的路由规则。

请求类型

如果指定请求类型注册路由的话,无需设置method请求类型参数。如果使用了rule或者any方法注册路由,或者使用路由配置定义文件的话,可以单独使用method参数进行请求类型检测。

使用方法:

// 检测路由规则仅GET请求有效
Route::any("new/:id","News/read",["method"=>"get"]);
// 检测路由规则仅GET和POST请求有效
Route::any("new/:id","News/read",["method"=>"get|post"]);

URL后缀

// 定义GET请求路由规则 并设置URL后缀为html的时候有效
Route::get("new/:id","News/read",["ext"=>"html"]);

支持匹配多个后缀,例如:

Route::get("new/:id","News/read",["ext"=>"shtml|html"]);

可以设置禁止访问的URL后缀,例如:

// 定义GET请求路由规则 并设置禁止URL后缀为png、jpg和gif的访问
Route::get("new/:id","News/read",["deny_ext"=>"jpg|png|gif"]);

V5.0.7版本以上,extdeny_ext参数允许设置为空,分别表示不允许任何后缀以及必须使用后缀访问。

域名检测

支持使用完整域名或者子域名进行检测,例如:

// 完整域名检测 只在news.thinkphp.cn访问时路由有效
Route::get("new/:id","News/read",["domain"=>"news.thinkphp.cn"]);
// 子域名检测
Route::get("new/:id","News/read",["domain"=>"news"]);

HTTPS检测

支持检测当前是否HTTPS访问

Route::get("new/:id","News/read",["https"=>true]);

前置行为检测

支持使用行为对路由进行检测是否匹配,如果行为方法返回false表示当前路由规则无效。

Route::get("user/:id","index/User/read",["before_behavior"=>"appindexehaviorUserCheck"]);

行为类定义如下:

namespace appindexehavior;

class UserCheck
{
    public function run()
    {
        if("user/0"==request()->url()){
            return false;
        }
    }
}

后置行为执行

可以为某个路由或者某个分组路由定义后置行为执行,表示当路由匹配成功后,执行的行为,例如:

Route::get("user/:id","User/read",["after_behavior"=>"appindexehaviorReadInfo"]);

其中appindexehaviorReadInit 行为类定义如下:

namespace appindexehavior;

use appindexmodelUser;

class ReadInfo {
    public function run(){
    	$id = request()->route("id");
		request()->user = User::get($id);
    }
}

如果成功匹配到new/:id路由后,就会执行行为类的run方法,参数是路由地址,可以动态改变。

Callback检测

也可以支持使用函数检测路由,如果函数返回false则表示当前路由规则无效,例如:

Route::get("new/:id","News/read",["callback"=>"my_check_fun"]);

合并额外参数

通常用于完整匹配的情况,如果有额外的参数则合并作为变量值,例如:

Route::get("new/:name$","News/read",["merge_extra_vars"=>true]);

http://serverName/new/thinkphp/hello

会被匹配到,并且name变量的值为 thinkphp/hello

配置文件中添加路由参数

如果使用配置文件的话,可以使用:

return [
    "blog/:id"   => ["Blog/update",["method" => "post","ext"=>"html|shtml"]],
];

路由绑定模型(V5.0.1

可以在当前路由匹配后绑定模型,后面则同过方法的对象自动注入来获取。

Route::get("new/:name$","News/read",["bind_model"=>["User","name"]]);

更多细节可以参考请求->依赖注入。

缓存路由请求

可以对当前的路由请求进行缓存处理,例如:

Route::get("new/:name$","News/read",["cache"=>3600]);

表示对当前路由请求缓存3600秒。