Laravel12怎么用Route::domain给子域名单独配置路由组-php教程-PHP中文网

Laravel 12 中子域名路由必须用 Route::domain() 在 routes/web.php 中按顺序定义，基于 Host 头匹配，支持泛域名 {sub}.example.com 和 where 约束，须置于根域名路由之前，并配合 DNS 泛解析与 SESSION_DOMAIN=.example.com 配置。

laravel12怎么用route::domain给子域名单独配置路由组

在 Laravel 12 中，用 Route::domain() 给子域名单独配置路由组，核心是**按 Host 头精准匹配 + 路由分组隔离 + 正确注册时机**。它不是加前缀，而是基于 HTTP 请求的域名字段做路由分支，必须写在 routes/web.php（或 api.php）中，且顺序很关键。

✅ 必须写在 routes/web.php 里，不能放错位置

Laravel 12 的路由加载机制没变：所有 Route::domain() 必须定义在 routes/web.php 文件内（默认已由 RouteServiceProvider 自动加载）。不要试图在中间件、控制器或服务提供者里动态注册——那不会生效。

确保你修改的是 routes/web.php，不是 app/Providers/RouteServiceProvider.php
不要用 Route::prefix('shop.example.com') 替代，这完全无效，Laravel 不会解析 prefix 为域名
泛域名写法如 {sub}.example.com 中的 {sub} 是路由参数，会在控制器方法或闭包中自动注入

✅ 按子域名分组写法示例

每个 Route::domain() 定义一个独立作用域，互不干扰：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

// 匹配 shop.example.com 及其子路径
Route::domain('shop.example.com')->group(function () {
    Route::get('/', [ShopController::class, 'index'])->name('shop.home');
    Route::get('/products', [ShopController::class, 'list']);
});

// 匹配 api.example.com
Route::domain('api.example.com')->group(function () {
    Route::get('/v1/status', fn() => response()->json(['ok' => true]));
    Route::post('/v1/orders', [Api\OrderController::class, 'store']);
});

// 泛匹配：匹配任意一级子域名，如 us.example.com、jp.example.com
Route::domain('{locale}.example.com')->group(function () {
    Route::get('/', function (string $locale) {
        return view('home', ['locale' => $locale]);
    })->where('locale', '[a-z]{2}');
});