域名路由 · ThinkPHP5.1完全开发手册

## 域名路由 ThinkPHP支持完整域名、子域名和IP部署的路由和绑定功能，同时还可以起到简化URL的作用。可以单独给域名设置路由规则，例如给blog子域名注册单独的路由规则： ~~~ Route::domain('blog', function () { // 动态注册域名的路由规则 Route::rule('new/:id', 'index/news/read'); Route::rule(':user', 'index/user/info'); }); ~~~ >[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]); ~~~