Laravel多数据库配置详解教程

本文深入解析了在Laravel中实现多数据库配置的完整五步法——从config/database.php中定义命名连接、.env中安全配置环境变量，到通过模型$connection属性绑定、DB门面动态切换，再到Eloquent查询链中灵活使用on()临时指定连接，覆盖了生产环境中多库协作的核心场景；无论你是需要分离分析库与主业务库、实现读写分离，还是应对微服务化数据源整合，这套清晰、安全、可维护的实践方案都能帮你彻底摆脱“所有查询都跑在默认库”的困境，让多数据库真正为业务所用。

如果您在Laravel项目中需要同时访问多个数据库，但所有查询仍默认指向单一连接，则说明多数据库配置尚未生效。以下是实现多数据库连接的具体方法：

一、在config/database.php中定义多个连接

此步骤用于注册命名连接，每个连接必须具有唯一键名，并完整声明驱动、主机、端口、库名、凭证等参数。Laravel不会自动推断主从或读写角色，所有连接均需显式命名并引用。

1、打开config/database.php文件，定位到'connections'数组。

2、在该数组内新增一个连接配置，例如'mysql_analytics'，确保键名不与现有连接（如mysql）重复。

3、为新连接设置'driver'为'mysql'或'pgsql'等有效驱动，且对应PHP扩展已启用（如pdo_pgsql）。

4、所有敏感字段（如host、database）必须通过env()函数读取，例如'host' => env('DB_ANALYTICS_HOST', '127.0.0.1')，禁止硬编码。

5、确认未覆盖默认连接mysql的配置，该连接仍应保留用于迁移、通知等依赖默认连接的内部组件。

二、在.env文件中配置对应环境变量

环境变量是隔离不同数据库凭据的关键手段，每个连接应使用语义化前缀避免冲突，确保配置可移植且安全。

1、在.env文件末尾添加新数据库的独立变量组，例如以DB_ANALYTICS_为统一前缀。

2、至少定义DB_ANALYTICS_HOST、DB_ANALYTICS_PORT、DB_ANALYTICS_DATABASE、DB_ANALYTICS_USERNAME、DB_ANALYTICS_PASSWORD五项。

3、若使用PostgreSQL连接，还需确保DB_ANALYTICS_DRIVER=pgsql，并在config/database.php中匹配该驱动值。

4、运行php artisan config:clear清除配置缓存，使新变量立即生效。

三、在Eloquent模型中绑定指定连接

模型通过$connection属性静态绑定连接，适用于长期固定使用某库的业务模型，如日志表、报表表等。

1、创建或打开目标模型类，例如app/Models/AnalyticsLog.php。

2、在类体顶部添加protected $connection = 'mysql_analytics';，其值必须与config/database.php中connections下的键名完全一致。

3、设置protected $table指定该连接中的具体表名，例如'analytics_events'。

4、验证：调用AnalyticsLog::first()时，SQL将发送至mysql_analytics所配置的数据库服务器。

四、使用DB门面动态切换连接

此方式适用于单次查询、跨模型聚合或按请求上下文分流场景，不修改模型状态，灵活性最高。

1、在控制器或服务类中引入Illuminate\Support\Facades\DB。

2、调用DB::connection('mysql_analytics')获取指定连接的实例，返回对象非全局单例。

3、在其后链式调用->table('events')->where(...)->get()执行查询。

4、若需事务保护，必须在同一次DB::connection(...)->transaction()内完成全部操作，跨连接事务不生效。

五、在Eloquent查询中临时切换连接

当仅需对某个模型的一次性操作使用非默认库时，可避免修改模型定义，保持代码轻量。

1、在查询链起始处调用User::on('mysql_analytics')，传入已在config/database.php中注册的连接名。

2、后续所有链式方法（如->where()、->get()）均基于该连接执行。

3、也可对新建实例调用$user->setConnection('mysql_analytics')再执行save()，但该设置仅作用于当前实例。

4、注意：on()和setConnection()均不改变模型类的$connection属性，不影响其他实例。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Laravel多数据库配置详解教程》文章吧，也可关注golang学习网公众号了解相关技术文章。