域名路由

可以单独给域名设置路由规则，同时还可以起到简化URL的作用。

域名路由

可以单独给域名设置路由规则，例如给blog子域名注册单独的路由规则：

Route::domain('blog', function () {
    // 动态注册域名的路由规则
    Route::rule('new/:id', 'news/read');
    Route::rule(':user', 'user/info');
});

一旦定义了域名路由，该域名的访问就只会读取域名路由定义的路由规则。

闭包中可以使用路由的其它方法，包括路由分组，但不能再包含域名路由

支持同时对多个域名设置相同的路由规则：

Route::domain(['blog', 'admin'], function () {
    // 动态注册域名的路由规则
    Route::rule('new/:id', 'news/read');
    Route::rule(':user', 'user/info');
});

如果你需要设置一个路由跨所有域名都可以生效，可以对分组路由或者某个路由使用crossDomainRule方法设置：

Route::group( function () {
    // 动态注册域名的路由规则
    Route::rule('new/:id', 'news/read');
    Route::rule(':user', 'user/info');
})->crossDomainRule();

域名绑定

绑定到控制器类

// blog子域名绑定控制器
Route::domain('blog', '@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', 'news/read');
    Route::rule(':user', 'user/info');
})->append(['app_id'=>1]);

上面的域名路由统一传入了app_id参数，该参数的值可以通过Request类的param方法获取。

也可以直接在域名绑定后传入额外参数

Route::domain('blog', 'blog')
	->append(['app_id'=>1]);

路由参数

域名路由本身也是一个路由分组，所以可以和路由分组一样定义公共的路由参数，例如：

Route::domain('blog', function () {
    // 动态注册域名的路由规则
    Route::rule('new/:id', 'news/read');
    Route::rule(':user', 'user/info');
})->ext('html')
->pattern(['id' => '\d+'])
->append(['group_id' => 1]);