0

0

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

冰火之心

冰火之心

发布时间:2025-12-03 13:42:06

|

352人浏览过

|

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

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

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

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

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

百度MCP广场
百度MCP广场

探索海量可用的MCP Servers

下载

在查询构造器中切换连接

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

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2678

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1659

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1515

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1419

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1235

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1488

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

PHP WebSocket 实时通信开发
PHP WebSocket 实时通信开发

本专题系统讲解 PHP 在实时通信与长连接场景中的应用实践,涵盖 WebSocket 协议原理、服务端连接管理、消息推送机制、心跳检测、断线重连以及与前端的实时交互实现。通过聊天系统、实时通知等案例,帮助开发者掌握 使用 PHP 构建实时通信与推送服务的完整开发流程,适用于即时消息与高互动性应用场景。

11

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号