Laravel 12 域名限制中间件需用 #[Middleware] 属性语法，校验 host 头并剔除端口，仅允许 app.example.com 和 admin.example.com；配合 Route::domain() 分组绑定该中间件，并同步配置 APP_URL 与 SESSION_DOMAIN。
用 Cursor 生成 Laravel 12 的域名限制中间件和 Route::domain() 配置，核心是让 AI 理解你的项目结构、需求场景和 Laravel 12 的新特性（比如 PHP 8.2+ 属性语法支持、更严格的类型提示）。Cursor 本身不直接“生成可运行代码”，而是基于你写的注释、上下文和指令，帮你快速写出符合规范的代码。关键在于提问方式和上下文引导。
明确告诉 Cursor 你要什么（精准 Prompt）
在 Cursor 的聊天框或代码文件中添加注释时，用清晰、带约束的自然语言描述，例如：
-
目标：为 Laravel 12 创建一个中间件，只允许请求来自
app.example.com和admin.example.com，其他域名返回 404 -
技术要求：使用 PHP 8.2+ 属性语法（如
#[Middleware]），兼容 Laravel 12 的中间件注册方式；不修改全局中间件组，仅用于特定路由组 -
配套配置：同时生成对应的
routes/web.php示例，用Route::domain()按域名分组，并绑定该中间件 -
额外提醒：检查
APP_URL和SESSION_DOMAIN环境变量是否需同步调整（Laravel 12 默认启用严格域匹配）
生成域名限制中间件（App\Http\Middleware\RestrictDomains.php）
在 app/Http/Middleware 目录下新建文件，光标放在空文件里，输入类似以下注释，按 Ctrl+K（或 Cmd+K）触发 Cursor：
// @cursor generate a Laravel 12 middleware that checks HTTP_HOST against allowed domains: ['app.example.com', 'admin.example.com'].
// Return abort(404) if not matched. Use #[Middleware] attribute. Do NOT use $request->getHost() — use $request->headers->get('host') and normalize to lowercase.
// Skip port number (e.g. 'app.example.com:8000' → 'app.example.com').Cursor 通常会输出类似：
#[Middleware]
class RestrictDomains
{
protected array $allowedDomains = [
'app.example.com',
'admin.example.com',
];
public function handle(Request $request, Closure $next): Response
{
$host = $request->headers->get('host');
$cleanHost = explode(':', $host)[0] ?? $host;
$cleanHost = strtolower(trim($cleanHost));
if (! in_array($cleanHost, $this->allowedDomains)) {
abort(404);
}
return $next($request);
}
}
配置 Route::domain() 分组并应用中间件
打开 routes/web.php，在合适位置（如顶部或分组前）加入注释触发 Cursor：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
// @cursor write Route::domain() groups for 'app.example.com' and 'admin.example.com', each with its own route group. // Apply the RestrictDomains middleware to both groups. Inside app.*: show welcome; inside admin.*: show dashboard.
Cursor 可能生成：
use App\Http\Middleware\RestrictDomains;
Route::domain('{app}.example.com')
->middleware(RestrictDomains::class)
->group(function () {
Route::get('/', function () {
return view('welcome');
})->name('app.home');
});
Route::domain('admin.example.com')
->middleware(RestrictDomains::class)
->group(function () {
Route::get('/', function () {
return view('dashboard');
})->name('admin.home');
});
⚠️ 注意：Route::domain() 支持通配符（如 {app}.example.com），但中间件仍需显式绑定；Laravel 12 不再自动将子域名参数注入闭包，如需动态处理，请改用 Route::pattern() 或在控制器中解析 request()->route('app')。
本地测试与环境适配要点
生成后别直接上线，做三件事：
-
hosts 文件临时映射：在
/etc/hosts（macOS/Linux）或C:\Windows\System32\drivers\etc\hosts（Windows）加两行：127.0.0.1 app.example.com127.0.0.1 admin.example.com -
验证中间件行为：访问
http://test.example.com应返回 404；访问http://app.example.com:8000应正常加载 -
检查 .env：确保
APP_URL=https://app.example.com，且SESSION_DOMAIN=.example.com（带前导点，支持跨子域会话）
