Laravel 多域名扩展安装与使用指南

Laravel 多域名扩展安装与使用指南

laravel-multidomain A Laravel extension for using a laravel application on a multi domain setting 项目地址: https://gitcode.com/gh_mirrors/la/laravel-multidomain

项目介绍

Laravel 多域名扩展（gecche/laravel-multidomain）是一个专为 Laravel 开发的应用程序框架扩展，它使得单一的 Laravel 安装能够服务于多个不同的HTTP域名。这一功能特别适用于那些在代码结构上相同但数据库、存储和配置各异的不同客户场景。通过这个包，您可以在每个特定的域名下拥有独立的环境文件、存储路径以及数据库配置。

项目快速启动

安装步骤

1. 添加依赖：首先，在您的 composer.json 文件中的 require 部分添加此扩展。

   "require": {
       "gecche/laravel-multidomain": "^11.*"
   }
   

   或者直接运行以下命令来安装：

   composer require gecche/laravel-multidomain
   

2. 更新配置：

   • 修改 bootstrap/app.php 文件，替换 Illuminate\Foundation\Application 为 Gecche\Multidomain\Foundation\Application。
   • 在 config/app.php 中，替换原始的 QueueServiceProvider 为 Gecche\Multidomain\Queue\QueueServiceProvider。

3. 发布配置：

   php artisan vendor:publish
   

4. 配置修改： 根据提示完成必要的配置调整，确保多域名功能可以正确识别及处理。

基础使用

添加新域名到您的应用中，例如添加 example1.com 和 example2.com：

php artisan domain:add example1.com
php artisan domain:add example2.com

这将创建对应的环境文件如 .env.example1.com 和 .env.example2.com，并为每个站点配置数据库和缓存等信息。

应用案例和最佳实践

假设您运营一个SaaS平台，不同客户要求他们的数据隔离且有单独的入口URL，此时可以利用此扩展轻松实现。为每个客户创建专属的环境设置，比如数据库连接、缓存前缀，甚至定制部分应用行为，而不需为每位客户部署完全独立的应用实例。

最佳实践：

• 对于每个域名，维护独立的.env文件来管理数据库凭据和其他敏感信息。
• 使用Git忽略所有特定域名的.env文件，以保护敏感数据。
• 确保在生产环境中正确设置了域名绑定，避免安全风险。

典型生态项目

在多域环境下，可能需要集成其他Laravel生态系统中的工具，如Laravel Horizon，用于队列监控。本扩展提供了与之兼容的方法，确保即使在多域名架构中，队列管理和监控也能无缝进行：

1. 安装Laravel Horizon 按照Laravel官方文档正常安装。
2. 修改Horizon服务提供者 在 app/Providers/HorizonServiceProvider.php 的顶部替换默认的 HorizonApplicationServiceProvider 为扩展提供的版本。

   use Gecche\Multidomain\Horizon\HorizonApplicationServiceProvider;
   

3. 确保队列工作进程指定正确的域名：

   php artisan queue:work --domain=example1.com --queue=my_queue
   

这样一来，您不仅实现了多域名下的应用服务，也保证了后台任务的有序执行和监控。

---

通过遵循上述步骤，您可以有效地在Laravel项目中实施多域名策略，为不同用户提供个性化且隔离的服务环境。记得详细阅读项目文档以获取更高级的使用方式和最新的更新信息。

laravel-multidomain A Laravel extension for using a laravel application on a multi domain setting 项目地址: https://gitcode.com/gh_mirrors/la/laravel-multidomain