域名路由
ThinkPHP支持完整域名、子域名和IP部署的路由和绑定功能,同时还可以起到简化URL的作用。
要启用域名部署路由功能,首先需要开启:
"url_domain_deploy" => true
定义域名部署规则支持两种方式:动态注册和配置定义。
动态注册
可以在应用的公共文件或者配置文件中动态注册域名部署规则,例如:
// blog子域名绑定到blog模块
Route::domain("blog","blog");
// 完整域名绑定到admin模块
Route::domain("admin.thinkphp.cn","admin");
// IP绑定到admin模块
Route::domain("114.23.4.5","admin");
blog子域名绑定后,URL访问规则变成:
// 原来的URL访问
http://www.thinkphp.cn/blog/article/read/id/5
// 绑定到blog子域名访问
http://blog.thinkphp.cn/article/read/id/5
支持绑定的时候添加默认参数,例如:
// blog子域名绑定到blog模块
Route::domain("blog","blog?var=thinkphp");
除了绑定到模块之外,还隐式传入了一个$_GET["var"] = "thinkphp"
变量。
支持直接绑定到控制器,例如:
// blog子域名绑定到index模块的blog控制器
Route::domain("blog","index/blog");
URL访问地址变化为:
// 原来的URL访问
http://www.thinkphp.cn/index/blog/read/id/5
// 绑定到blog子域名访问
http://blog.thinkphp.cn/read/id/5
如果你的域名后缀比较特殊,例如是com.cn
或者net.cn
之类的域名,需要配置:
"url_domain_root"=>"thinkphp.com.cn"
泛域名部署
可以支持泛域名部署规则,例如:
// 绑定泛二级域名域名到book模块
Route::domain("*","book?name=*");
下面的URL访问都会直接访问book模块
http://hello.thinkphp.cn
http://quickstart.thinkphp.cn
并且可以直接通过$_GET["name"]变量 获取当前的泛域名。
支持三级泛域名部署,例如:
// 绑定泛三级域名到user模块
Route::domain("*.user","user?name=*");
如果我们访问如下URL地址:
http://hello.user.thinkphp.cn
的同时,除了会访问user模块之外,还会默认传入 $_GET["name"] = "hello"
在配置传入参数的时候,如果需要使用当前的泛域名作为参数,可以直接设置为“*”即可。
目前只支持二级域名和三级域名的泛域名部署。
配置定义方式
除了动态注册之外,还支持直接在路由配置文件中定义域名部署规则,例如:
return [
"__domain__"=>[
"blog" => "blog",
// 泛域名规则建议在最后定义
"*.user" => "user",
"*" => "book",
],
// 下面是路由规则定义
]
域名绑定地址
前面我们看到的域名部署规则:
// blog子域名绑定到blog模块
Route::domain("blog","blog");
其实是把域名绑定到模块的方式,其实还有其他的绑定方式。
绑定到命名空间
// blog子域名绑定命名空间
Route::domain("blog","applogcontroller");
绑定到类
// blog子域名绑定到类
Route::domain("blog","@applogcontrollerArticle");
绑定到闭包函数
如果需要,你也可以直接把域名绑定到一个闭包函数,例如:
// blog子域名绑定闭包函数
Route::domain("blog",function(){
echo "hello";
return ["bind"=>"module","module"=>"blog"];
});
域名绑定到闭包函数其实是一种劫持,可以在闭包函数里面动态注册其它的绑定机制或者注册新的路由,例如:
Route::domain("www", function(){
// 动态注册域名的路由规则
Route::rule("new/:id", "index/news/read");
Route::rule(":user", "index/user/info");
});
如果你不希望继续,可以直接在闭包函数里面中止执行。
// blog子域名绑定到闭包函数
Route::domain("blog",function(){
exit("hello");
});
绑定路由规则
可以把域名绑定到一系列指定的路由规则,例如:
Route::domain("blog",[
// 动态注册域名的路由规则
":id" => ["blog/read",["method"=>"GET"],["id"=>"d+"]],
":name"=>"blog/read",
]);
如果使用配置文件配置的话,可以按照下面的方式:
return [
"__domain__"=>[
"blog" => [
// 动态注册域名的路由规则
":id" => ["blog/read",["method"=>"GET"],["id"=>"d+"]],
":name"=>"blog/read",
],
],
// 下面是其它的路由规则定义
]
更详细的绑定功能请参考路由绑定一章内容。