ThinkPHP支持完整域名、子域名和IP部署的路由和绑定功能,同时还可以起到简化URL的作用。

要启用域名部署路由功能,首先需要开启:

  1. 'url_domain_deploy' => true

定义域名部署规则支持两种方式:动态注册和配置定义。

动态注册

可以在应用的公共文件或者配置文件中动态注册域名部署规则,例如:

  1. // blog子域名绑定到blog模块
  2. Route::domain('blog','blog');
  3. // 完整域名绑定到admin模块
  4. Route::domain('admin.thinkphp.cn','admin');
  5. // IP绑定到admin模块
  6. Route::domain('114.23.4.5','admin');

blog子域名绑定后,URL访问规则变成:

  1. // 原来的URL访问
  2. http://www.thinkphp.cn/blog/article/read/id/5
  3. // 绑定到blog子域名访问
  4. http://blog.thinkphp.cn/article/read/id/5

支持绑定的时候添加默认参数,例如:

  1. // blog子域名绑定到blog模块
  2. Route::domain('blog','blog?var=thinkphp');

除了绑定到模块之外,还隐式传入了一个$_GET['var'] = 'thinkphp' 变量。

支持直接绑定到控制器,例如:

  1. // blog子域名绑定到index模块的blog控制器
  2. Route::domain('blog','index/blog');

URL访问地址变化为:

  1. // 原来的URL访问
  2. http://www.thinkphp.cn/index/blog/read/id/5
  3. // 绑定到blog子域名访问
  4. http://blog.thinkphp.cn/read/id/5

如果你的域名后缀比较特殊,例如是com.cn或者net.cn 之类的域名,需要配置:

  1. 'url_domain_root'=>'thinkphp.com.cn'

泛域名部署

可以支持泛域名部署规则,例如:

  1. // 绑定泛二级域名域名到book模块
  2. Route::domain('*','book?name=*');

下面的URL访问都会直接访问book模块

  1. http://hello.thinkphp.cn
  2. http://quickstart.thinkphp.cn

并且可以直接通过$_GET['name']变量 获取当前的泛域名。

支持三级泛域名部署,例如:

  1. // 绑定泛三级域名到user模块
  2. Route::domain('*.user','user?name=*');

如果我们访问如下URL地址:

  1. http://hello.user.thinkphp.cn

的同时,除了会访问user模块之外,还会默认传入 $_GET['name'] = 'hello'

在配置传入参数的时候,如果需要使用当前的泛域名作为参数,可以直接设置为“*”即可。

目前只支持二级域名和三级域名的泛域名部署。

配置定义方式

除了动态注册之外,还支持直接在路由配置文件中定义域名部署规则,例如:

  1. return [
  2. '__domain__'=>[
  3. 'blog' => 'blog',
  4. // 泛域名规则建议在最后定义
  5. '*.user' => 'user',
  6. '*' => 'book',
  7. ],
  8. // 下面是路由规则定义
  9. ]

域名绑定地址

前面我们看到的域名部署规则:

  1. // blog子域名绑定到blog模块
  2. Route::domain('blog','blog');

其实是把域名绑定到模块的方式,其实还有其他的绑定方式。

绑定到命名空间

  1. // blog子域名绑定命名空间
  2. Route::domain('blog','\app\blog\controller');

绑定到类

  1. // blog子域名绑定到类
  2. Route::domain('blog','@\app\blog\controller\Article');

绑定到闭包函数

如果需要,你也可以直接把域名绑定到一个闭包函数,例如:

  1. // blog子域名绑定闭包函数
  2. Route::domain('blog',function(){
  3. echo 'hello';
  4. return ['bind'=>'module','module'=>'blog'];
  5. });

域名绑定到闭包函数其实是一种劫持,可以在闭包函数里面动态注册其它的绑定机制或者注册新的路由,例如:

  1. Route::domain('www', function(){
  2. // 动态注册域名的路由规则
  3. Route::rule('new/:id', 'index/news/read');
  4. Route::rule(':user', 'index/user/info');
  5. });

如果你不希望继续,可以直接在闭包函数里面中止执行。

  1. // blog子域名绑定到闭包函数
  2. Route::domain('blog',function(){
  3. exit('hello');
  4. });

绑定路由规则

可以把域名绑定到一系列指定的路由规则,例如:

  1. Route::domain('blog',[
  2. // 动态注册域名的路由规则
  3. ':id' => ['blog/read',['method'=>'GET'],['id'=>'\d+']],
  4. ':name'=>'blog/read',
  5. ]);

如果使用配置文件配置的话,可以按照下面的方式:

  1. return [
  2. '__domain__'=>[
  3. 'blog' => [
  4. // 动态注册域名的路由规则
  5. ':id' => ['blog/read',['method'=>'GET'],['id'=>'\d+']],
  6. ':name'=>'blog/read',
  7. ],
  8. ],
  9. // 下面是其它的路由规则定义
  10. ]

更详细的绑定功能请参考路由绑定一章内容。