Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Umum / Cara Menghubungkan Laravel den...
Umum

Cara Menghubungkan Laravel dengan MySQL dan MariaDB dari Nol

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
4 min read
6 views

Overview

Database menyimpan data utama aplikasi, mulai dari akun pengguna hingga transaksi dan laporan. Kesalahan konfigurasi host, credential, nama database, atau migration dapat menyebabkan Laravel gagal membaca maupun menulis data. Artikel ini memandu developer membuat database, menyiapkan user, mengatur .env, menguji koneksi, dan menjalankan migration awal.

Laravel menggunakan koneksi database yang didefinisikan di file konfigurasi. MySQL dan MariaDB biasanya dapat digunakan melalui driver koneksi mysql, tetapi kompatibilitas tetap bergantung pada versi database, PHP, dan Laravel yang dipakai.

Prerequisites

  • PHP sesuai requirement Laravel.
  • Laravel 11/12 atau versi yang digunakan proyek.
  • MySQL atau MariaDB versi yang didukung oleh versi Laravel dan driver PHP.
  • Ekstensi PDO dan pdo_mysql aktif.
  • Hak akses untuk membuat database dan user.
  • MySQL client atau tool administrasi database.

Periksa ekstensi PHP:

php -m

Pastikan daftar modul memuat PDO dan pdo_mysql.

Step-by-step tutorial

1. Pastikan database server berjalan

Pada Laragon, jalankan service database. Pada Linux, gunakan service manager sesuai distribusi dan nama paket yang dipasang. Periksa client:

mysql --version

Untuk mengetahui versi server setelah login, jalankan:

SELECT VERSION();

Versi client tidak selalu sama dengan versi server, sehingga jangan menggunakan output client sebagai satu-satunya bukti versi database.

2. Buat database dan user aplikasi

Contoh SQL untuk development:

CREATE DATABASE katalog_produk
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

CREATE USER 'katalog_user'@'localhost'
  IDENTIFIED BY 'GANTI_PASSWORD_KUAT';

GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP
  ON katalog_produk.* TO 'katalog_user'@'localhost';

FLUSH PRIVILEGES;

Ganti password contoh dengan credential kuat. Hak CREATE, ALTER, dan DROP dapat dibutuhkan saat menjalankan migration. Untuk runtime production, pertimbangkan memisahkan credential aplikasi dari credential deployment/migration dan membatasi hak sesuai kebutuhan.

3. Atur file .env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=katalog_produk
DB_USERNAME=katalog_user
DB_PASSWORD="GANTI_PASSWORD_KUAT"

Pastikan nama database dan host cocok. localhost dan 127.0.0.1 dapat diperlakukan berbeda tergantung sistem dan konfigurasi database.

4. Bersihkan config cache dan uji koneksi

php artisan config:clear
php artisan migrate:status

Jika command dapat terhubung, periksa status migration. Jika database baru belum memiliki tabel migration, kondisi tersebut belum tentu berarti koneksi gagal.

5. Jalankan migration

php artisan migrate
php artisan migrate:status

Jangan menjalankan migrate:fresh pada database yang menyimpan data penting karena command tersebut menghapus tabel sebelum membuat ulang skema. Di production, tinjau migration dan backup terlebih dahulu.

6. Buat model dan migration contoh

php artisan make:model Product -m

Contoh kolom:

Schema::create('products', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->decimal('price', 12, 2);
    $table->timestamps();
});

Jalankan migration setelah memeriksa nama database yang sedang digunakan. Pilih tipe data berdasarkan kebutuhan domain dan aturan perhitungan aplikasi.

7. Verifikasi melalui test atau seeder

Gunakan seeder atau test untuk membuat data contoh. Jangan memasukkan data dummy ke production. Gunakan Eloquent atau Query Builder dengan parameter binding; hindari menyusun SQL mentah dari input pengguna.

Troubleshooting

  • could not find driver: aktifkan pdo_mysql pada PHP CLI atau PHP-FPM yang benar-benar dipakai.
  • Access denied: periksa password, host account, dan grant.
  • Connection refused: pastikan database berjalan dan port/host benar.
  • Unknown database: buat database atau perbaiki DB_DATABASE.
  • Perubahan .env tidak terbaca: jalankan php artisan config:clear dan periksa worker.
  • Migration gagal karena tabel sudah ada: periksa status migration dan skema aktual sebelum melakukan perubahan manual.
  • Masalah charset/collation: gunakan charset yang didukung, umumnya utf8mb4, dan cocokkan collation dengan versi server.

Best practices

Gunakan user database khusus, bukan root. Backup sebelum migration berisiko dan uji perubahan di staging. Pantau query lambat, tambahkan index berdasarkan pola akses, dan pisahkan credential runtime dari credential deployment jika diperlukan. Jangan menjalankan command destruktif di production tanpa rencana pemulihan yang jelas.

Related articles

Last tested

Tanggal penyusunan: 19 Oktober 2026. SQL dan command belum diuji pada kombinasi versi MySQL/MariaDB tertentu. Uji pada database development dan sesuaikan grant serta collation dengan versi server.

Bagikan artikel:

Artikel lainnya

Cari Artikel