laravel如何连接并操作多个数据库_Laravel多数据库连接与操作方法-Laravel-PHP中文网

laravel如何连接并操作多个数据库_Laravel多数据库连接与操作方法

冰火之心

发布： 2025-10-19 11:30:03

原创

970人浏览过

Laravel支持多数据库配置，可在config/database.php中定义多个连接，并通过.env文件管理环境变量；在模型中设置$connection属性或使用DB::connection()、on()、setConnection()方法实现连接切换；事务基于单一连接，跨库操作需自行处理一致性；迁移时可通过--database指定连接。

laravel如何连接并操作多个数据库_laravel多数据库连接与操作方法

Laravel 支持轻松配置和操作多个数据库连接，适用于需要跨数据库读写数据的场景，比如主从分离、微服务间数据交互或按业务模块分库的情况。通过合理配置，可以在同一个项目中灵活切换不同数据库进行操作。

配置多数据库连接

Laravel 的数据库配置文件位于 config/database.php，你可以在其中定义多个连接。默认已包含 mysql、pgsql 等连接示例，你可以新增或修改：

'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', ''),
    // ...
],
<p>'mysql_second' => [
'driver' => 'mysql',
'host' => env('DB_SECOND_HOST', '192.168.1.100'),
'port' => env('DB_SECOND_PORT', '3306'),
'database' => env('DB_SECOND_DATABASE', 'second_db'),
'username' => env('DB_SECOND_USERNAME', 'user'),
'password' => env('DB_SECOND_PASSWORD', ''),
// 其他配置项同上
],</p>

登录后复制

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

DB_SECOND_HOST=192.168.1.100
DB_SECOND_PORT=3306
DB_SECOND_DATABASE=second_db
DB_SECOND_USERNAME=user
DB_SECOND_PASSWORD=secret

登录后复制

在模型中指定数据库连接

Laravel 的 Eloquent 模型默认使用配置中的默认连接（通常是 mysql）。要使用其他连接，可在模型中设置 $connection 属性：

class Order extends Model
{
    protected $connection = 'mysql_second';
    protected $table = 'orders';
}

登录后复制

这样所有对 Order 模型的操作都会走 mysql_second 连接。

运行时动态切换数据库连接

除了在模型中固定指定，还可以在查询时动态切换连接：

库宝AI

库宝AI是一款功能多样的智能伙伴助手，涵盖AI写作辅助、智能设计、图像生成、智能对话等多个方面。

109

查看详情

使用 DB 门面指定连接：

$results = DB::connection('mysql_second')->select("SELECT * FROM users");

登录后复制

在 Eloquent 查询中临时切换：

$users = User::on('mysql_second')->get();

登录后复制

保存数据到指定数据库：

$user = new User();
$user->setConnection('mysql_second');
$user->name = 'John Doe';
$user->save();

登录后复制

事务处理与注意事项

Laravel 的事务是基于连接的，因此跨数据库的事务无法保证 ACID。例如：

DB::connection('mysql')->transaction(function () {
    DB::table('logs')->insert(['action' => 'created']);
});

登录后复制

上述事务只作用于 mysql 连接。如果你尝试在一个事务中操作两个数据库，一旦出错，另一个数据库无法回滚，需自行处理补偿逻辑。

使用多数据库时注意以下几点：

确保每个连接的主机、账号权限正确
避免在高并发场景下频繁切换连接导致性能下降
迁移文件可指定连接：php artisan make:migration create_orders_table --database=mysql_second
执行迁移时也需指定：`php artisan migrate --database=mysql_second`

基本上就这些。Laravel 的多数据库支持很实用，只要配置清楚，切换自然，就能满足大多数复杂业务需求。

以上就是laravel如何连接并操作多个数据库_Laravel多数据库连接与操作方法的详细内容，更多请关注php中文网其它相关文章！