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
PDOdanpdo_mysqlaktif. - 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: aktifkanpdo_mysqlpada 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 perbaikiDB_DATABASE.- Perubahan
.envtidak terbaca: jalankanphp artisan config:cleardan 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
- Konfigurasi Environment Laravel
- Database, ERD, dan Migration
- Optimasi Query MySQL
- Backup dan Restore Database
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.