Laravel多数据库配置需五步实现：一、在config/database.php的connections中定义命名连接；二、在.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。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
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属性，不影响其他实例。
