Laravel如何连接多个数据库_Laravel多数据库连接配置与切换教程-Laravel-PHP中文网

laravel支持多数据库连接，适用于读写分离、多租户等场景。通过config/database.php配置多个连接，如mysql_second，并在.env文件中设置对应环境变量；在eloquent模型中使用$connection指定连接名，或在查询时通过db::connection('name')切换；支持事务和运行时动态切换连接，需确保连接名唯一且配置正确。

laravel如何连接多个数据库_laravel多数据库连接配置与切换教程

Laravel 支持同时连接多个数据库，适用于需要跨数据库操作的场景，比如读写分离、多租户系统或整合不同业务模块的数据源。配置和切换多数据库连接并不复杂，只需合理设置配置文件并正确调用即可。

配置多数据库连接

Laravel 的数据库配置位于 config/database.php 文件中。默认情况下，Laravel 已定义了多种数据库连接方式（如 mysql、pgsql 等），你可以在此基础上添加多个数据库连接。

例如，添加第二个 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_second' => [
    'driver' => 'mysql',
    'host' => env('DB_SECOND_HOST', '127.0.0.1'),
    'port' => env('DB_SECOND_PORT', '3306'),
    'database' => env('DB_SECOND_DATABASE', 'second_db'),
    'username' => env('DB_SECOND_USERNAME', 'second_user'),
    'password' => env('DB_SECOND_PASSWORD', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
],

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

DB_SECOND_HOST=127.0.0.1
DB_SECOND_PORT=3306
DB_SECOND_DATABASE=your_second_db
DB_SECOND_USERNAME=your_second_user
DB_SECOND_PASSWORD=your_password

在模型中指定数据库连接

每个 Eloquent 模型都可以通过 $connection 属性指定使用哪个数据库连接。

例如，创建一个模型使用第二个数据库：

uni-app

uni-app 官方文档、npm 包和项目创建入口。

下载

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class SecondDbUser extends Model
{
    protected $connection = 'mysql_second'; // 对应 config/database.php 中的连接名
    protected $table = 'users';
}

这样，所有对该模型的操作都会自动使用 mysql_second 连接。

在查询构造器中切换连接

如果你使用的是 DB 门面进行原生查询或构建查询，可以通过 connection() 方法指定连接：

use Illuminate\Support\Facades\DB;

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

// 使用第二个数据库连接
$secondUsers = DB::connection('mysql_second')->table('users')->get();

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

DB::connection('mysql_second')->transaction(function () {
    DB::connection('mysql_second')->table('users')->update(['active' => 1]);
});

在运行时动态切换连接

有时需要根据用户、租户或环境动态切换数据库。可以在控制器或服务中根据条件设置连接：

$dynamicConnection = $tenant->isPremium ? 'mysql_premium' : 'mysql_default';

$users = DB::connection($dynamicConnection)->table('users')->get();

确保这些连接已在 config/database.php 中预先定义。

基本上就这些。只要配置好连接，在模型或查询中明确指定，Laravel 就能轻松管理多个数据库。注意连接名称不要冲突，环境变量要正确加载，避免运行时错误。