域名路由
域名路由
ThinkPHP支持完整域名、子域名和IP部署的路由和绑定功能,同时还可以起到简化URL的作用。
可以单独给域名设置路由规则,例如给blog子域名注册单独的路由规则:
Route::domain('blog', function () {
// 动态注册域名的路由规则
Route::rule('new/:id', 'index/news/read');
Route::rule(':user', 'index/user/info');
});
闭包中可以使用路由的其它方法,包括路由分组,甚至给域名设置MISS路由。
支持数组的方式:
Route::domain('blog', [
// 动态注册域名的路由规则
':id' => ['blog/read', ['method' => 'GET'], ['id' => '\d+']],
':name' => 'blog/read',
]);
支持同时对多个域名设置相同的路由规则:
Route::domain(['blog', 'admin'], function () {
// 动态注册域名的路由规则
Route::rule('new/:id', 'index/news/read');
Route::rule(':user', 'index/user/info');
});
如果你需要设置一个路由跨所有域名都可以生效,可以对分组路由或者某个路由使用crossDomainRule
方法设置:
Route::group('', function () {
// 动态注册域名的路由规则
Route::rule('new/:id', 'index/news/read');
Route::rule(':user', 'index/user/info');
})->crossDomainRule();
域名绑定
绑定到模块
除了设置域名的路由规则之外,还支持单独给域名进行路由绑定,例如绑定到模块:
// 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子域名绑定到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
之类的域名,需要在应用配置文件app.php
中配置:
'url_domain_root' => 'thinkphp.com.cn'
如果你需要同时定义域名路由和进行域名绑定的话,可以使用下面的方式(V5.1.6+
版本有效)
Route::domain('blog', function () {
// 动态注册域名的路由规则
Route::rule('new/:id', 'index/news/read');
Route::rule(':user', 'index/user/info');
})->bind('blog');
同样也支持绑定到命名空间或者类。
绑定到命名空间
// blog子域名绑定命名空间
Route::domain('blog', ':\app\blog\controller');
绑定到类
// blog子域名绑定到类
Route::domain('blog', '\app\blog\controller\Article');
泛域名部署
可以支持泛域名部署规则,例如:
// 绑定泛二级域名域名到book模块
Route::domain('*', 'book');
下面的URL访问都会直接访问book模块
http://hello.thinkphp.cn
http://quickstart.thinkphp.cn
并且可以直接通过Request::panDomain()
获取当前的泛域名值。
支持三级泛域名部署,例如:
// 绑定泛三级域名到user模块
Route::domain('*.user', 'user');
也支持直接把泛域名的值作为额外参数传入
// 绑定泛三级域名到user模块
Route::domain('*.user', 'user?name=*');
就可以通过Request::param('name')
获取当前泛域名的值
目前只支持二级域名和三级域名的泛域名部署。
绑定到Response对象
可以直接绑定某个域名到Response
对象,例如:
// 绑定域名到Response对象
Route::domain('test', response()->code(404));
如果域名需要同时定义路由规则,并且对其它的情况进行绑定操作,可以在闭包里面执行绑定操作,例如:
Route::domain('blog', function () {
// 动态注册域名的路由规则
Route::rule('new/:id', 'index/news/read');
})->bind('blog');
在blog
域名下面定义了一个new/:id
的路由规则,指向index
模块,而其它的路由则绑定到blog
模块。
传入额外参数
可以在域名绑定或者路由定义后传入额外的隐藏参数,例如:
Route::domain('blog', function () {
// 动态注册域名的路由规则
Route::rule('new/:id', 'index/news/read');
Route::rule(':user', 'index/user/info');
})->append(['app_id'=>1]);
上面的域名路由统一传入了app_id
参数,该参数的值可以通过Request
类的param
方法获取。
也可以直接在域名绑定后传入额外参数
Route::domain('blog', 'blog')
->append(['app_id'=>1]);