Laravel 5.5 动态数据库实现：为用户创建专属库及动态连接方法

我来一步步帮你搞定这个需求——每个用户对应专属数据库的动态连接，在Laravel 5.5里完全可以落地，咱们从基础配置到实际操作一步步来：

1. 先配置基础数据库连接 #

首先打开config/database.php，确保你的默认连接（比如mysql）用来存储用户核心信息（比如users表），然后在connections数组里新增一个动态数据库的模板配置，比如叫user_dynamic：

'connections' => [
    '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,
    ],

    // 新增的动态用户数据库模板
    'user_dynamic' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST', '127.0.0.1'),
        'port' => env('DB_PORT', '3306'),
        'database' => '', // 留空，后续动态赋值
        'username' => env('DB_USERNAME', 'forge'),
        'password' => env('DB_PASSWORD', ''),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'strict' => true,
        'engine' => null,
    ],
],

⚠️ 注意：你的数据库用户需要拥有创建数据库的权限，不然后续自动建库会报错。

2. 用户注册时自动创建专属数据库 #

在用户完成注册的逻辑里（比如RegisterController的create方法），我们要把用户昵称转成合法的数据库名称，然后自动创建对应的数据库：

use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;

// 先保存用户基础信息
$user = User::create([
    'name' => $data['name'],
    'email' => $data['email'],
    'password' => bcrypt($data['password']),
]);

// 生成合法数据库名：用昵称的slug形式+前缀，避免特殊字符
$dbName = 'user_' . Str::slug($user->name);

// 执行建库SQL
DB::statement("CREATE DATABASE IF NOT EXISTS `{$dbName}` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");

// 把数据库名存到users表，方便后续调用
$user->update(['db_name' => $dbName]);

如果担心昵称重复，可以在slug后面追加用户ID，比如user_{$user->id}_ . Str::slug($user->name)，保证数据库名唯一。

3. 全局中间件实现登录后自动切换连接 #

用户登录后，我们需要自动切换到他的专属数据库，这里用全局中间件最方便，所有请求都会自动处理：

先创建中间件：

php artisan make:middleware SwitchUserDatabase

然后打开app/Http/Middleware/SwitchUserDatabase.php，修改handle方法：

use Closure;
use Illuminate\Support\Facades\DB;

class SwitchUserDatabase
{
    public function handle($request, Closure $next)
    {
        // 仅登录用户才切换数据库
        if (auth()->check()) {
            $user = auth()->user();
            $dbName = $user->db_name;

            // 获取动态模板配置，替换数据库名称
            $config = config('database.connections.user_dynamic');
            $config['database'] = $dbName;

            // 更新配置并清除连接缓存（关键！避免复用旧连接）
            config()->set('database.connections.user_dynamic', $config);
            DB::purge('user_dynamic');

            // 可选：把默认连接设为用户专属库，这样所有未指定连接的模型都会用这个库
            // DB::setDefaultConnection('user_dynamic');
        }

        return $next($request);
    }
}

最后把这个中间件注册到全局中间件组，打开app/Http/Kernel.php，在$middleware数组里添加：

protected $middleware = [
    // ...其他已存在的中间件
    \App\Http\Middleware\SwitchUserDatabase::class,
];

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

你的用户专属业务模型（比如订单、个人资料）需要指定使用user_dynamic连接，比如：

namespace App;

use Illuminate\Database\Eloquent\Model;

class UserOrder extends Model
{
    // 指定使用动态用户数据库连接
    protected $connection = 'user_dynamic';

    // ...其他模型逻辑
}

这样用户登录后，这个模型就会自动操作他的专属数据库了。

5. 给新数据库同步表结构 #

创建完空数据库后，需要把你的业务表结构同步进去，在用户注册完成后执行迁移即可：

use Illuminate\Support\Facades\Artisan;

// 建库完成后执行迁移
Artisan::call('migrate', [
    '--database' => 'user_dynamic', // 指定用动态连接
    '--path' => database_path('migrations/user'), // 可选：如果用户专属表的迁移单独存放
    '--force' => true, // 生产环境需要加这个，跳过确认提示
]);

建议把用户专属表的迁移文件放在database/migrations/user目录下，避免和系统表迁移混淆。

关键注意事项 #

• 权限问题：确保数据库用户有CREATE DATABASE权限，否则建库失败。
• 连接缓存：必须调用DB::purge('user_dynamic')，否则Laravel会复用之前的连接，导致切换无效。
• 重名处理：一定要保证生成的数据库名唯一，避免昵称重复导致冲突。

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