~ We are changing the world with technology. ~

Matt Mullenweg

Laravel Multiple Database MySql & MongoDB

Laravel Multiple Database MySql & MongoDB

3077 Dilihat

Pendahuluan

Ada beragam kasus dimana sebuah aplikasi menggunakan lebih dari satu database secara bersamaan, misalnya saja pada aplikasi yang sedang saya kerjakan saat ini, dimana aplikasi yang baru (Aplikasi A) membutuhkan data dari aplikasi lama (Aplikasi B), akan tetapi pada aplikasi B tidak memungkinkan untuk membuat API karena satu dan lain hal.

Multiple database akan sangat membantu karena kita bisa mengambil data secara langsung dari database aplikasi B tanpa harus merepotkan pihak lain untuk menyediakan API service. Artikel kali ini akan membahas bagaimana berinteraksi dengan lebih dari satu database & contoh kasus yang lebih sederhana.

Case yang akan kita angkat adalah membuat CRUD untuk data produk menggunakan MySQL dan CRUD untuk data kategori menggunakan MongoDB.

laravel multiple database

Instalasi & Persiapan

Sebelum melanjutkan ke tahap persiapan, saya asumsikan teman-teman sudah meng-install web server, mysql dan mongodb, pastikan juga php module untuk mysql & mongodb sudah diaktifkan. Adapun materi tentang instalasinya akan dibahas pada artikel yang berbeda.

Laravel yang akan digunakan adalah Laravel 6, dari command line, jalankan perintah

composer create-project --prefer-dist laravel/laravel laravel-multidb "6.*"

Package yang akan digunakan untuk mengelola koneksi ke Mongo adalah Laravel-MongoDB, masuk ke dalam project dan install package berikut

cd laravel-multidb
composer require jenssegers/mongodb

Buka file config/database.php dan tambahkan code berikut di dalam connections

//[.. CODE SEBELUMNYA  ..]
'mongodb' => [
    'driver'   => 'mongodb',
    'host'     => env('MONGO_DB_HOST', 'localhost'),
    'port'     => env('MONGO_DB_PORT', 27017),
    'database' => env('MONGO_DB_DATABASE'),
    'username' => env('MONGO_DB_USERNAME'),
    'password' => env('MONGO_DB_PASSWORD'),
    'options'  => []
],

Buka file .env dan modifikasi konfigurasi mysql pada line berikut

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=multidb-mysql
DB_USERNAME=root
DB_PASSWORD=

Note: Pastikan kamu sudah membuat database bernama multidb-mysql.

Masih dengan file yang sama, tambahkan konfigurasi untuk MongoDB

MONGO_DB_HOST=127.0.0.1
MONGO_DB_PORT=27017
MONGO_DB_DATABASE=laravel-multidb
MONGO_DB_USERNAME=
MONGO_DB_PASSWORD=

Note: Pastikan kamu sudah membuat database Mongo bernama laravel-multidb.

Saatnya kita membuat migration untuk table products yang akan di-handle oleh MySql, dari command line, jalankan

php artisan make:model Product -m

Buka file migration yang baru saja di-generate dan modifikasi menjadi

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateProductsTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('products', function (Blueprint $table) {
            $table->bigIncrements('id');
            $table->string('title');
            $table->integer('price');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('products');
    }
}

MongoDBnya bagaimana? Karena Mongo ini berorientasi dokumen, maka kita tidak membutuhkan table sebagaimana yang dilakukan sebelumnya. Eksekusi migration diatas dengan command

php artisan migrate

CRUD MySQL & MongoDB

Pengelolaan data dari kedua database ini akan kita kerjakan secara bersamaan, dimana frame browser akan dibagi menjadi dua bagian, yakni untuk menampilkan data products dan categories. Generate controller baru dengan command

php artisan make:controller ProductController

Buka file ProductController.php dan tambahkan method berikut

public function index()
{
    $product = Product::orderBy('created_at', 'DESC')->paginate(10);  //GET DATA DARI TABLE PRODUCT
    $category = Category::orderBy('created_at', 'DESC')->paginate(10); //GET DATA DARI COLLECTION MONGODB
    return view('welcome', compact('product', 'category'));
}

Masih dengan file yang sama, tambahkan use statement

use App\Product;
use App\Category;

Lalu bagaimana cara kedua Eloquent diatas untuk membedakan tujuan database-nya? Secara default, Laravel akan menggunakan config default dari database.php, dalam hal ini adalah mysql. Sehingga tugas kita hanyalah mendefinisikan model untuk ke mongodb-nya. Generate model Category dengan command

php artisan make:model Category

Buka file app/Category.php dan modifikasi menjadi

<?php

namespace App;

// use Illuminate\Database\Eloquent\Model;
use Jenssegers\Mongodb\Eloquent\Model as Eloquent;

class Category extends Eloquent
{
    protected $connection = 'mongodb';
    protected $guarded = [];
}

Penjelasan: mongodb adalah nama connections yang ada di config/database.php.

Kemudian kita akan mengelola tampilan dari data kedua database, buka file resources/views/welcome.blade.php dan modifikasi menjadi

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Laravel MultiDB</title>

    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">
</head>
<body>
    <div class="container">
        <div class="row">
            <div class="col-md-6 mt-3">
                <div class="card">
                    <div class="card-header">
                        <h3 class="card-title">DB1: MySQL</h3>
                    </div>
                    <div class="card-body">
                        <form action="{{ url('/mysql') }}" method="post">
                            @csrf
                            <div class="form-group">
                                <label for="">Title</label>
                                <input type="text" name="title" class="form-control">
                            </div>
                            <div class="form-group">
                                <label for="">Price</label>
                                <input type="text" name="price" class="form-control">
                            </div>
                            <button class="btn btn-primary btn-sm">Simpan</button>
                        </form>
                        <table class="table table-hover table-bordered mt-3">
                            <thead>
                                <tr>
                                    <th>No</th>
                                    <th>Title</th>
                                    <th>Price</th>
                                    <th>Action</th>
                                </tr>
                            </thead>
                            <tbody>
                                @forelse ($product as $key => $row)
                                <tr>
                                    <td>{{ $key+1 }}</td>
                                    <td>{{ $row->title }}</td>
                                    <td>{{ number_format($row->price) }}</td>
                                    <td>
                                        <form action="{{ url('/mysql/' . $row->id) }}" method="post">
                                            @csrf
                                            <input type="hidden" value="DELETE" name="_method">
                                            <a href="{{ url('/edit/' . $row->id . '/mysql') }}" class="btn btn-warning btn-sm">Edit</a>
                                            <button class="btn btn-danger btn-sm">Hapus</button>
                                        </form>
                                    </td>
                                </tr>
                                @empty
                                <tr>
                                    <td colspan="4" class="text-center">Tidak ada data</td>
                                </tr>
                                @endforelse
                            </tbody>
                        </table>
                    </div>
                </div>
            </div>
            <div class="col-md-6 mt-3">
                <div class="card">
                    <div class="card-header">
                        <h3 class="card-title">DB2: MongoDB</h3>
                    </div>
                    <div class="card-body">
                        <form action="{{ url('/mongo') }}" method="post">
                            @csrf
                            <div class="form-group">
                                <label for="">Kategori</label>
                                <input type="text" name="name" class="form-control">
                            </div>
                            <button class="btn btn-primary btn-sm">Simpan</button>
                        </form>
                        <table class="table table-hover table-bordered mt-3">
                            <thead>
                                <tr>
                                    <th>No</th>
                                    <th>Category</th>
                                    <th>Action</th>
                                </tr>
                            </thead>
                            <tbody>
                                @forelse ($category as $key => $row)
                                <tr>
                                    <td>{{ $key+1 }}</td>
                                    <td>{{ $row->name }}</td>
                                    <td>
                                        <form action="{{ url('mongo/' . $row->id) }}" method="post">
                                            @csrf
                                            <input type="hidden" value="DELETE" name="_method">
                                            <a href="{{ url('/edit/' . $row->id . '/mongo') }}" class="btn btn-warning btn-sm">Edit</a>
                                            <button class="btn btn-danger btn-sm">Hapus</button>
                                        </form>
                                    </td>
                                </tr>
                                @empty
                                <tr>
                                    <td colspan="3" class="text-center">Tidak ada data</td>
                                </tr>
                                @endforelse
                            </tbody>
                        </table>
                    </div>
                </div>
            </div>
        </div>
    </div>
    <script src="https://code.jquery.com/jquery-3.4.1.slim.min.js" integrity="sha384-J6qa4849blE2+poT4WnyKhv5vZF5SrPo0iEjwBvKU7imGFAV0wwj1yYfoRSJoZ+n" crossorigin="anonymous"></script>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/umd/popper.min.js" integrity="sha384-Q6E9RHvbIyZFJoft+2mJbHaEWldlvI9IOYy5n3zV9zzTtmI3UksdQRVvoxMfooAo" crossorigin="anonymous"></script>
    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/js/bootstrap.min.js" integrity="sha384-wfSDF2E50Y2D1uUdj0O3uMBJnjuUD4Ih7YwaYd1iqfktj0Uod8GCExl3Og8ifwB6" crossorigin="anonymous"></script>
</body>
</html>

Penjelasan: Perhatikan form untuk kedua input-an di atas, route untuk input-an data mysql ke /mysql dan untuk input-an ke mongo ke /mongo, dimana keduanya menggunakan method POST.

Untuk meng-handle masing-masing input-an di atas, buka file ProductController.php dan tambahkan kedua method berikut

public function insertToMySQL(Request $request)
{
    $this->validate($request, [
        'title' => 'required|string',
        'price' => 'required|integer'
    ]);

    Product::create([
        'title' => $request->title,
        'price' => $request->price
    ]);
    return redirect()->back();
}

public function insertToMongo(Request $request)
{
    $this->validate($request, [
        'name' => 'required|string'
    ]);

    Category::create(['name' => $request->name]);
    return redirect()->back();
}

Definisikan route untuk ketiga method yang sudah kita buat, buka file routes/web.php dan tambahkan code

Route::get('/', '[email protected]');
Route::post('/mysql', '[email protected]');
Route::post('/mongo', '[email protected]');

Untuk mengizinkan mass assignment ke products, buka file Product.php dan modifikasi menjadi

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    protected $guarded = [];
}

Dua langkah terakhir adalah membuat fitur hapus dan update data. Buka kembali file ProductController.php dan tambahkan method

public function deleteMySQL($id)
{
    $product = Product::find($id);
    $product->delete();
    return redirect()->back();
}

public function deleteMongo($id)
{
    $category = Category::find($id);
    $category->delete();
    return redirect()->back();
}

Kemudian definisikan routing untuk menghapus data, buka file routes/web.php dan tambahkan code

Route::delete('/mongo/{id}', '[email protected]');
Route::delete('/mysql/{id}', '[email protected]');

Adapun form untuk edit akan kita satukan & hanya dibedakan oleh type, buka file ProductController.php dan tambahkan method

public function formEdit($id, $type)
{
    if ($type == 'mysql') {
        $product = Product::find($id);
        return view('edit', compact('product', 'type'));
    }
    $category = Category::find($id);
    return view('edit', compact('category', 'type'));
}

public function update(Request $request, $id, $type)
{
    if ($type == 'mysql') {
        $product = Product::find($id);
        $product->update([
            'title' => $request->title,
            'price' => $request->price
        ]);
        return redirect('/');
    }
    $category = Category::find($id);
    $category->update(['name' => $request->name]);
    return redirect('/');
}

Handle form edit-nya dengan membuat file edit.blade.php di dalam folder resources/views dan tambahkan code berikut

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Laravel MultiDB</title>

    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">
</head>
<body>
    <div class="container">
        <div class="row">
            @if ($type == 'mysql')
            <div class="col-md-6 mt-3">
                <div class="card">
                    <div class="card-header">
                        <h3 class="card-title">DB1: MySQL</h3>
                    </div>
                    <div class="card-body">
                        <form action="{{ url('/edit/' . $product->id . '/mysql') }}" method="post">
                            @csrf
                            <input type="hidden" name="_method" value="PUT">
                            <div class="form-group">
                                <label for="">Title</label>
                                <input type="text" name="title" class="form-control" value="{{ $product->title }}">
                            </div>
                            <div class="form-group">
                                <label for="">Price</label>
                                <input type="text" name="price" class="form-control" value="{{ $product->price }}">
                            </div>
                            <button class="btn btn-primary btn-sm">Simpan</button>
                            <a href="{{ url('/') }}" class="btn btn-secondary btn-sm">Kembali</a>
                        </form>
                    </div>
                </div>
            </div>
            @else
            <div class="col-md-6 mt-3">
                <div class="card">
                    <div class="card-header">
                        <h3 class="card-title">DB2: MongoDB</h3>
                    </div>
                    <div class="card-body">
                        <form action="{{ url('/edit/' . $category->id . '/mongo') }}" method="post">
                            @csrf
                            <input type="hidden" name="_method" value="PUT">
                            <div class="form-group">
                                <label for="">Kategori</label>
                                <input type="text" name="name" class="form-control" value="{{ $category->name }}">
                            </div>
                            <button class="btn btn-primary btn-sm">Simpan</button>
                            <a href="{{ url('/') }}" class="btn btn-secondary btn-sm">Kembali</a>
                        </form>
                    </div>
                </div>
            </div>
            @endif
        </div>
    </div>
    <script src="https://code.jquery.com/jquery-3.4.1.slim.min.js" integrity="sha384-J6qa4849blE2+poT4WnyKhv5vZF5SrPo0iEjwBvKU7imGFAV0wwj1yYfoRSJoZ+n" crossorigin="anonymous"></script>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/umd/popper.min.js" integrity="sha384-Q6E9RHvbIyZFJoft+2mJbHaEWldlvI9IOYy5n3zV9zzTtmI3UksdQRVvoxMfooAo" crossorigin="anonymous"></script>
    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/js/bootstrap.min.js" integrity="sha384-wfSDF2E50Y2D1uUdj0O3uMBJnjuUD4Ih7YwaYd1iqfktj0Uod8GCExl3Og8ifwB6" crossorigin="anonymous"></script>
</body>
</html>

Langkah terakhir adalah mendefinisikan route untuk form edit dan update data, buka file routes/web.php

Route::get('/edit/{id}/{type}', '[email protected]');
Route::put('/edit/{id}/{type}', '[email protected]');

Kesimpulan

Berinteraksi dengan multiple database di Laravel sangatlah mudah karena didukung oleh fitur yang sudah disediakan oleh Laravel, sehingga kita hanya perlu melakukan konfigurasi untuk koneksi database, dan selanjutnya sudah di-handle oleh Eloquent layaknya ketika kita menggunakan single database.

Adapun dokumentasi code dari artikel ini bisa dilihat di Github.

Full Stack Developer & Remote Worker salah satu perusahaan asal Australia. Senang dengan teknologi baru. Laravel addict yang tidak fanatik. Merekam jejak dengan menulis

Membuat Login & Register Laravel 8 Laravel

Membuat Login & Register Laravel 8

Laravel tak henti-hentinya memperkaya fitur yang dimilikinya untuk "memanjakan" penggunanya. Lain sisi, Laravel memberikan pesan tersirat, bahwasanya sebagai orang yang "nyemplung" dibidang teknologi,...

Aplikasi E-Commerce Laravel 6 #20: Auto Upload Produk Marketplace Laravel

Aplikasi E-Commerce Laravel 6 #20: Auto...

Dewasa ini, marketplace menjadi platform untuk jual-beli yang banyak digemari baik bagi penjual maupun pembeli karena banyaknya promo yang diberikan oleh platform tersebut. Sehingga, data produk biasa...

Aplikasi E-Commerce Laravel 6 #19: Fitur Ongkos Kirim Laravel

Aplikasi E-Commerce Laravel 6 #19: Fitur...

Sejak pertama kali serial Membuat Aplikasi E-Commerce Laravel 6 di-release, ada banyak permintaan untuk menerapkan fitur ongkos kirim, namun kendalanya, tidak satupun yang memiliki license ongkos kiri...

Komentar