Laravel多数据库配置需在config/database.php中定义命名连接、.env中设置对应环境变量、模型中绑定连接或使用DB门面动态切换。
如果您在Laravel项目中需要同时访问多个数据库（如主业务库、分析库、遗留系统库），但所有查询仍默认指向单一mysql连接，则说明多数据库连接尚未启用。以下是实现该目标的多种配置方法：
一、在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模型中静态绑定指定连接
该方式适用于长期固定使用某数据库的业务模型，例如日志表、报表表或租户专属表，模型实例化后所有操作自动路由至目标连接。
1、创建或打开目标模型类，例如app/Models/AnalyticsEvent.php。
2、在类体顶部添加protected $connection = 'mysql_analytics';，其值必须与config/database.php中connections下的键名完全一致。
3、设置protected $table指定该连接中的具体表名，例如'analytics_events'。
4、验证：调用AnalyticsEvent::first()时，SQL将发送至mysql_analytics所配置的数据库服务器。
四、使用DB门面动态切换连接
该方式适用于运行时按需选择数据库的场景，如后台管理中跨库查询、数据同步任务等，无需修改模型结构即可灵活路由。
1、在控制器或服务类中引入Illuminate\Support\Facades\DB。
2、调用DB::connection('mysql_analytics')获取指定连接实例。
3、在其后链式调用查询方法，例如->table('events')->where('type', 'click')->get()。
4、注意：事务仅作用于单个连接，DB::connection('a')->transaction()内不可混用connection('b')的查询。
五、在Eloquent查询中临时指定连接
该方式提供轻量级连接切换能力，适合在已有模型基础上临时读写其他数据库，不改变模型默认行为。
1、在查询链起始处调用Model::on('mysql_analytics')，例如User::on('mysql_analytics')->where('active', 1)->get()。
2、该调用返回一个新的查询构建器实例，后续所有操作均基于目标连接执行。
3、若需保存新记录到该库，可先实例化模型，再调用setConnection('mysql_analytics')。
4、注意：on()方法仅在Laravel 9.x及以上版本原生支持，8.x需升级或改用DB::connection()。
