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

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','\app\blog\controller'); ~~~ ### 绑定到类 ~~~ // blog子域名绑定到类 Route::domain('blog','@\app\blog\controller\Article'); ~~~ ### 绑定到闭包函数如果需要，你也可以直接把域名绑定到一个闭包函数，例如： ~~~ // 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', ], ], // 下面是其它的路由规则定义 ] ~~~ 更详细的绑定功能请参考路由绑定一章内容。