域名路由

优质

小牛编辑

138浏览

2023-12-01

域名路由

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]);