Laravel如何配置和使用多个数据库连接-Laravel-PHP中文网

Laravel支持多数据库连接配置，通过在config/database.php中定义如mysql_secondary连接，并在.env文件添加对应环境变量，可在Eloquent模型中设置$connection属性指定连接，或使用DB::connection('mysql_secondary')在查询构造器中切换连接，支持事务和动态切换，适用于主从分离等场景。

laravel如何配置和使用多个数据库连接

在Laravel中配置和使用多个数据库连接非常灵活，适用于需要操作不同数据库（如主从分离、微服务数据隔离或跨系统集成）的场景。你只需在配置文件中定义多个连接，然后在模型或查询中指定使用哪一个即可。

配置多个数据库连接

Laravel的数据库配置位于 config/database.php 文件中。默认情况下，它支持多种数据库驱动，并允许你定义多个连接。

例如，你想添加一个名为 mysql_secondary 的额外MySQL连接：

'mysql' => [
    'driver' => 'mysql',
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '3306'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    // 其他配置...
],

'mysql_secondary' => [
    'driver' => 'mysql',
    'host' => env('DB_SECONDARY_HOST', '192.168.1.100'),
    'port' => env('DB_SECONDARY_PORT', '3306'),
    'database' => env('DB_SECONDARY_DATABASE', 'secondary_db'),
    'username' => env('DB_SECONDARY_USERNAME', 'user'),
    'password' => env('DB_SECONDARY_PASSWORD', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
],

记得在 .env 文件中添加对应的环境变量：

DB_SECONDARY_HOST=192.168.1.100
DB_SECONDARY_PORT=3306
DB_SECONDARY_DATABASE=secondary_db
DB_SECONDARY_USERNAME=user
DB_SECONDARY_PASSWORD=secret

在Eloquent模型中使用指定连接

如果你有一个模型需要使用 mysql_secondary 连接，可以在模型类中设置 $connection 属性：

<?php namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class SecondaryUser extends Model
{
    protected $connection = 'mysql_secondary';
    protected $table = 'users';
}

这样，所有对该模型的操作都会自动使用指定的数据库连接。

Seasonal Keyword Planner

将电商关键词映射到12个月需求曲线，生成逐月的listing、广告和内容发布时间表。

下载

在查询构造器中切换连接

如果只是临时使用某个连接，可以直接在查询时指定：

// 使用默认连接
$users = DB::table('users')->get();

// 使用 mysql_secondary 连接
$secondaryUsers = DB::connection('mysql_secondary')->table('users')->get();

也可以在事务中使用特定连接：

DB::connection('mysql_secondary')->transaction(function () {
    DB::connection('mysql_secondary')->table('logs')->insert([
        'action' => 'user_login',
        'created_at' => now()
    ]);
});

在运行时动态切换连接

某些场景下，你可能需要根据用户、租户或配置动态选择数据库。可以通过修改模型实例的连接来实现：

$userModel = new SecondaryUser();
$userModel->setConnection('mysql_secondary');
$users = $userModel->get();
// 记得恢复，避免影响后续调用
$userModel->setConnection(null);

或者，在服务中注入连接名称：

public function getUsersFrom($connectionName)
{
    return DB::connection($connectionName)->table('users')->get();
}

基本上就这些。Laravel对多数据库的支持很清晰，关键是把配置写对，然后在模型或查询中明确指定连接名。不复杂但容易忽略细节，比如环境变量拼写或连接名大小写。