信息发布→ 登录 注册 退出

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

发布时间:2025-12-03

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

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 属性指定使用哪个数据库连接。

例如,创建一个模型使用第二个数据库:

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 就能轻松管理多个数据库。注意连接名称不要冲突,环境变量要正确加载,避免运行时错误。

标签:# 多个  # 并在  # 只需  # 就能  # 你可以  # 如果你  # 的是  # 可以通过  # 适用于  # 第二个  # laravel  # 数据库  # database  # 配置文件  # 环境变量  # app  # cad  # word  # php  # mysql  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!