Panduan Praktis Konfigurasi Multi Database di Laravel

Pendahuluan

Bayangkan lagi ngerjain aplikasi yang butuh narik data dari legacy database milik klien, sementara sistem utama kita jalan di database terpisah; di sinilah fitur multi-connection Laravel jadi penyelamat. Seringkali kita terjebak mikir kalau Laravel cuma bisa ngobrol sama satu database saja, padahal fleksibilitas framework ini sebenarnya sangat dalam kalau kita berani ngulik config-nya.

Tips & Best Practices

• Di banyak project, biasanya saya mulai dengan mendefinisikan connection name yang deskriptif di file config/database.php agar nggak bingung pas aplikasi makin kompleks.
• Saat ngerjain fitur yang akses banyak database, saya selalu pakai env variable khusus agar credential tiap DB terisolasi dengan rapi dan nggak bocor ke lingkungan lain.
• Biasanya saya buat Base Model khusus yang memanggil connection berbeda untuk memisahkan logika data antar database secara clean.

Contoh Kode

Kalau kita mau nembak data ke koneksi lain secara on-the-fly, biasanya saya pakai cara ini:

// Mengakses database kedua secara langsung
$users = DB::connection('mysql_client_b')
    ->table('users')
    ->get();

Atau kalau pakai Eloquent, cukup definisikan properti ini di modelnya:

class ClientData extends Model {
    protected $connection = 'mysql_client_b';
}

Variasi Implementasi

Kita bisa pakai cara statis lewat model buat kasus yang koneksinya tetap, atau cara dinamis pakai DB::purge() dan DB::reconnect() kalau di runtime kita butuh pindah-pindah database berdasarkan tenant atau user tertentu. Cara statis jelas lebih aman untuk maintenance, tapi cara dinamis adalah kunci kalau kamu lagi membangun arsitektur multi-tenant.

Kesalahan Umum

• Lupa melakukan purge connection saat berganti database di tengah request yang sama, sering bikin data nyasar ke tempat yang salah.
• Menaruh semua credential database di file config langsung tanpa lewat environment variable, ini bahaya banget buat keamanan.
• Tidak mengelola transaction antar database dengan benar, padahal kalau database-nya beda, Laravel nggak bisa handle transaksi lintas database secara otomatis.
• Salah sangka kalau migration bakal otomatis lari ke database yang diinginkan tanpa memberikan flag --database.
• Mengabaikan timeout koneksi yang berbeda antar server, padahal koneksi ke server remote biasanya jauh lebih lambat dari localhost.

Ringkasan

Intinya, multi-database di Laravel itu bukan soal seberapa canggih kodenya, tapi soal seberapa rapi kita memisahkan tanggung jawab antar koneksi. Setelah berkali-kali ngerjain setup ini, kuncinya cuma satu: selalu konsisten dengan penamaan koneksi dan jangan pernah malas buat testing connection di environment staging sebelum deploy.