Laravel多域名配置技巧与实战方法

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《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:\Windows\System32\drivers\etc\hosts（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 Illuminate\Support\Facades\Request;

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

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

以上就是《Laravel多域名配置技巧与实战方法》的详细内容，更多关于的资料请关注golang学习网公众号！