Cara Mengelola Multi Database Connection di Laravel dengan Efektif

Pendahuluan

Bayangin lagi ngerjain fitur sederhana, tapi tiba-tiba requirement berubah dan minta datanya ditarik dari database legacy yang beda server. Laravel sebenernya udah siap banget buat ginian, tapi seringkali kita malah ribet sendiri karena nggak paham alurnya dari awal. Saya sendiri pernah ngerasa pusing pas harus misahin data transaksi sama data log ke database yang berbeda, tapi ternyata setelah dipahami, konfigurasinya malah bikin hidup jauh lebih tenang.

Tips & Best Practices

Di banyak project, biasanya saya mulai dari menata file config/database.php dengan teliti, jangan biarkan credential database nempel di hardcoded logic agar tim lain nggak kena masalah akses. Lalu, pastikan pakai environment variable .env yang konsisten agar pas pindah staging ke production nggak perlu ubah kode lagi. Terakhir, saya selalu bikin koneksi cadangan (default) yang bener-bener stabil supaya kalau koneksi ke db lain putus, aplikasi nggak crash total.

Contoh Kode

Pas lagi butuh akses db spesifik di controller atau service, saya biasanya langsung panggil di fly seperti ini:

// Mengambil data dari koneksi 'mysql_legacy'
$users = DB::connection('mysql_legacy')->table('users')->get();

// Atau kalau pakai model, ganti koneksinya di properti model
class LegacyUser extends Model {
    protected $connection = 'mysql_legacy';
}

Variasi Implementasi

Ada dua pendekatan yang sering saya pakai. Pertama, via Model: simpel dan bersih kalau satu tabel pasti selalu di db itu. Kedua, via DB Facade: fleksibel kalau kita harus switch koneksi secara dinamis berdasarkan input user (misal multi-tenancy sederhana). Keduanya punya trade-off; kalau terlalu sering gonta-ganti koneksi di controller, kodenya jadi susah dites. Jadi, pilihlah berdasarkan seberapa sering data itu diakses.

Kesalahan Umum

• Lupa nge-setup koneksi tambahan di config, akhirnya error "connection not found" pas deployment.
• Terlalu banyak pindah koneksi di dalam loop, ini bikin overhead koneksi database naik drastis.
• Nggak pakai database transaction yang scope-nya cross-database, padahal ini krusial buat data integrity.
• Copy-paste credential ke banyak file .env tanpa ada master checklist.
• Lupa nge-close connection secara eksplisit padahal koneksi ke server remote sedang lemot.

Ringkasan

Mengelola multi-database di Laravel itu sebenarnya cuma soal ketelitian di file konfigurasi. Kuncinya bukan cuma soal kodenya jalan, tapi gimana kita menjaga agar arsitektur tetap bersih meskipun database-nya tersebar di mana-mana. Kalau udah terbiasa, fitur ini justru jadi senjata rahasia buat ngerjain project skala enterprise yang datanya kompleks.