Laravel应用中如何动态连接多数据库并配置连接池？

嘿，我来帮你搞定这两个问题——数据库连接池配置，还有Laravel里对应二级域名的动态多库连接，这场景我之前也帮不少开发者处理过，实用性拉满！

一、Laravel中数据库连接池的设置 #

Laravel本身就基于Illuminate\Database实现了连接池机制，不用额外装太多扩展就能配置优化。直接修改config/database.php文件就行：

1. 找到你要配置连接池的数据库驱动（比如mysql），添加pool配置项：

'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', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
    // 连接池核心配置
    'pool' => [
        'min' => 2,       // 保持的最小空闲连接数，避免频繁创建销毁连接
        'max' => 10,      // 允许的最大连接数，防止数据库连接过载
        'idle' => 60,     // 空闲连接超时时间（秒），超时后自动释放
        'wait' => 3,      // 获取连接的等待超时时间（秒），超时则抛出异常
    ],
],

2. 参数说明：

• min：即使没有请求，也会保持指定数量的空闲连接，提升请求响应速度
• max：限制最大并发连接数，要和你的MySQL配置max_connections匹配，别超过数据库的承载上限
• idle：清理长时间闲置的连接，避免占用资源
• wait：防止请求无限等待连接，超时后可以捕获异常做降级处理

如果需要更精细化的控制（比如连接监控、自定义回收策略），可以用社区维护的连接池扩展，直接通过Composer安装后按文档配置即可。

二、Laravel中基于二级域名的动态多数据库连接 #

你尝试的拆分SERVER_NAME的思路是对的，不过可以把逻辑抽离成中间件，让代码更优雅，还能结合连接池一起用。具体步骤如下：

1. 配置动态连接模板 #

先在config/database.php的connections数组里，新增一个模板连接（所有城市数据库的配置都基于这个模板）：

'city_template' => [
    'driver' => 'mysql',
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '3306'),
    'database' => '', // 留空，后面动态填充城市名
    'username' => env('DB_USERNAME', 'root'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
    // 同样加上连接池配置
    'pool' => [
        'min' => 2,
        'max' => 8,
        'idle' => 60,
        'wait' => 3,
    ],
],

2. 创建动态切换数据库的中间件 #

执行命令生成中间件：

php artisan make:middleware SwitchDatabaseBySubdomain

打开app/Http/Middleware/SwitchDatabaseBySubdomain.php，修改handle方法：

public function handle(Request $request, Closure $next)
{
    // 获取当前请求的域名，拆分出二级域名
    $host = $request->getHost();
    $subdomain = explode('.', $host)[0];

    // 验证子域名是否合法（防止非法请求）
    // 可以把合法数据库名存在.env或配置文件里，更灵活
    $validDatabases = explode(',', env('VALID_CITY_DBS', 'chicago,newyork,losangeles'));
    if (!in_array($subdomain, $validDatabases)) {
        abort(403, 'Invalid subdomain');
    }

    // 基于模板生成动态连接配置
    config([
        'database.connections.city_dynamic' => array_merge(
            config('database.connections.city_template'),
            ['database' => $subdomain]
        )
    ]);

    // 可选：设置默认连接为动态连接，这样所有模型默认用这个库
    // DB::setDefaultConnection('city_dynamic');

    return $next($request);
}

3. 注册中间件 #

打开app/Http/Kernel.php，把中间件加到web中间件组里（这样所有web请求都会自动切换数据库）：

protected $middlewareGroups = [
    'web' => [
        // ... 其他中间件
        \App\Http\Middleware\SwitchDatabaseBySubdomain::class,
    ],
];

4. 在模型中指定动态连接 #

如果没设置默认连接，就在需要的模型里指定使用city_dynamic连接：

class Article extends Model
{
    protected $connection = 'city_dynamic';
    // ... 其他模型代码
}

这样，当请求来自chicago.example.com时，Article模型就会自动连接chicago数据库，同时享受连接池的复用机制。

5. 额外优化建议 #

• 把合法的城市数据库名单存在缓存里，避免每次请求都读取env文件
• 如果用队列任务，因为队列没有HTTP请求上下文，需要把城市信息作为任务参数传递，然后在任务里手动设置连接
• 定期监控数据库连接数，根据实际流量调整连接池的min和max参数

内容的提问来源于stack exchange，提问作者zwl1619