how to use multiple database connections in larave

How to use and make multiple database connections in Laravel

Spread the love

In this tutorial I will guide you on how to use multiple databases in Laravel.

Step1 — Add following in your .env file

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=database1
DB_USERNAME=root
DB_PASSWORD=secret

DB_CONNECTION_SECOND=mysql
DB_HOST_SECOND=127.0.0.1
DB_PORT_SECOND=3306
DB_DATABASE_SECOND=database2
DB_USERNAME_SECOND=root
DB_PASSWORD_SECOND=secret

Step2 — Add following at config/database.php

'mysql' => [
    'driver'    => env('DB_CONNECTION'),
    'host'      => env('DB_HOST'),
    'port'      => env('DB_PORT'),
    'database'  => env('DB_DATABASE'),
    'username'  => env('DB_USERNAME'),
    'password'  => env('DB_PASSWORD'),
],

'mysql2' => [
    'driver'    => env('DB_CONNECTION_SECOND'),
    'host'      => env('DB_HOST_SECOND'),
    'port'      => env('DB_PORT_SECOND'),
    'database'  => env('DB_DATABASE_SECOND'),
    'username'  => env('DB_USERNAME_SECOND'),
    'password'  => env('DB_PASSWORD_SECOND'),
],

Step3 — Add following at app/config/database.php

return array(

    'default' => 'mysql',

    'connections' => array(

        # Primary/Default database connection
        'mysql' => array(
            'driver'    => 'mysql',
            'host'      => '127.0.0.1',
            'database'  => 'database1',
            'username'  => 'root',
            'password'  => 'secret'
            'charset'   => 'utf8',
            'collation' => 'utf8_unicode_ci',
            'prefix'    => '',
        ),

        # Secondary database connection
        'mysql2' => array(
            'driver'    => 'mysql',
            'host'      => '127.0.0.1',
            'database'  => 'database2',
            'username'  => 'root',
            'password'  => 'secret'
            'charset'   => 'utf8',
            'collation' => 'utf8_unicode_ci',
            'prefix'    => '',
        ),
    ),
);

Specify connection during migration

Schema::connection('mysql2')->create('some_table', function($table)
{
    $table->increments('id'):
});

Specify connection in QueryBuilder

$users = DB::connection('mysql2')->select(...);

Specify connection in Eloquent Models

class SomeModel extends Eloquent {

    protected $connection = 'mysql2';

}

Setting connection at run time

class SomeController extends BaseController {

    public function someMethod()
    {
        $someModel = new SomeModel;

        $someModel->setConnection('mysql2'); // non-static method

        $something = $someModel->find(1);

        $something = SomeModel::on('mysql2')->find(1); // static method

        return $something;
    }

}

2 thoughts to “How to use and make multiple database connections in Laravel”

  1. Please be aware that the method “Specify connection in Eloquent Models” makes testing a lot harder because the connection is now “hardcoded” so it won’t simply be replaced by the (default) test connection.

    iaw: Make sure you don’t mess up your “production” data when using such a model in your tests 🙂

    Cheers
    Pascal

Leave a Reply

Your email address will not be published. Required fields are marked *