如何在单个 Laravel 应用中运行多个域名或子域名

本文详解如何通过 laravel 路由 域分组（`route::domain()`）在同一应用中托管多个独立域名（如 site1.test、site2.test），共享代码库与功能，且无需重定向，关键在于路由注册顺序与 apache 虚拟主机配置。

Laravel 原生支持基于域名的路由分组，使你能在同一套代码中为不同域名（或子域名）提供差异化响应，同时复用模型、中间件、视图和业务逻辑。但一个常见陷阱是：若根域名路由（如 Route::get(‘/’)）先于 Route::domain() 注册，它将意外匹配所有请求（包括子域名），导致子域名路由失效。

✅ 正确做法：始终将 Route::domain() 分组置于 web.php 顶部，确保其优先注册：

// routes/web.php —— 正确顺序（关键！）Route::domain('site2.test')->group(function () {Route::get('/', function () {return view('site2.home'); // 或返回字符串     });      Route::get('/about', function () {return 'About page for Site 2';}); });  // 其他子域名…… Route::domain('admin.site1.test')->group(function () {Route::get('/', function () {return 'Admin dashboard';}); });  // 最后定义主域名（默认 fallback）Route::middleware(['web'])->group(function () {Route::get('/', function () {return view('site1.home'); // 默认响应 site1.test     });      Route::get('/contact', function () {return 'Contact for Site 1';}); });

? 注意事项与最佳实践：

• 路由顺序即匹配优先级：Laravel 按定义顺序匹配路由，Route::domain() 必须早于无域名约束的 Route::get()，否则后者会“兜底”捕获所有 / 请求；
• 虚拟主机配置需统一 DocumentRoot：如示例中两个 均指向 public/ 目录，确保所有域名由同一 Laravel 实例处理；
• 本地开发需同步 hosts 文件：

  # C:WindowsSystem32driversetchosts（Windows）或 /etc/hosts（macOS/Linux）127.0.0.1 site1.test 127.0.0.1 site2.test 127.0.0.1 admin.site1.test

• 生产环境建议使用通配符域名或动态解析：可结合 Request::getHost() 在控制器中动态判断当前域名，实现更灵活的内容分发（例如多租户首页）；
• 避免混合使用 Route::domain() 和 Route::prefix() 不当：子域名路由内不应再设冲突前缀；如需共享 API，推荐统一使用 api.php 并配合中间件鉴权。

? 扩展提示：若需根据域名加载不同配置（如数据库连接、主题、SEO 设置），可在 AppServiceProvider::boot() 中通过 request()->getHost() 动态切换：

use IlluminateSupportFacadesRequest;  public function boot() {     $host = Request::getHost();     if (str_contains($host, 'site2.test')) {config(['app.name' => 'Site Two']);         // 加载 site2 专属配置……     } }

通过合理组织路由、精准配置 Web 服务器，并善用 Laravel 的请求上下文能力，你即可零重定向、零重复部署地实现多站点统一运维——真正践行“一份代码，多域交付”。