🔥 ARTIKEL 4 DARI 50 Laravel Database Environment Config

🗄️

Setup Database dan Konfigurasi
File `.env`

Sambungkan aplikasi Laravel-mu ke database dengan benar — karena tanpa koneksi database, aplikasimu cuma HTML keren yang tidak bisa ngapa-ngapain.

⏱️

Estimasi Baca

8–10 Menit

🎯

Level

Pemula Friendly

📅

Update

2025

Bayangkan kamu baru saja selesai membangun rumah impian — desain keren, ruangan tertata rapi, semua furnitur sudah on point. Tapi ada satu masalah besar: tidak ada sambungan air. Keren? Iya. Bisa ditinggali? Belum. Nah, itulah kondisi proyekmu di Laravel kalau belum setup database dan file .env.

Saat kamu mulai mengenal Laravel framework secara serius, kamu akan sadar bahwa Laravel punya cara yang sangat elegan untuk mengelola konfigurasi — termasuk koneksi database. Tidak perlu hardcode username dan password di semua file. Semuanya terpusat di satu tempat: file .env. Di artikel ke-4 dari seri 50 Artikel Belajar Laravel ini, kamu akan belajar cara setup database dan mengkonfigurasi file .env dari nol hingga siap pakai!

📌 Konsep Utama

File .env = "Buku Rahasia" Laravel

File .env (environment) adalah file konfigurasi yang menyimpan semua data sensitif dan variabel lingkungan: nama database, username, password, API key, dan lainnya. File ini tidak boleh di-commit ke Git karena berisi informasi rahasia yang berbeda di setiap lingkungan (development, staging, production).

🔍 Mengenal File .env dalam Laravel Framework

Kalau kamu sudah melewati artikel sebelumnya tentang struktur folder Laravel, kamu pasti sudah melihat file .env nongkrong sendirian di root folder project. File ini terlihat sederhana, tapi perannya sangat vital.

Anggap saja file .env seperti kartu identitas aplikasimu. Setiap lingkungan punya identitas berbeda: di laptop kamu pakai database lokal, di server production pakai database cloud. Dengan file .env, kamu bisa ganti konfigurasi tanpa ubah satu baris pun di kode utama.

Variabel .env	Fungsi	Contoh Nilai
`APP_NAME`	Nama aplikasi Laravel	`MyApp`
`APP_ENV`	Mode lingkungan aplikasi	`local / production`
`APP_DEBUG`	Tampilkan error detail	`true / false`
`DB_CONNECTION`	Jenis database yang digunakan	`mysql / pgsql / sqlite`
`DB_HOST`	Alamat server database	`127.0.0.1`
`DB_DATABASE`	Nama database yang dipakai	`laravel_db`
`DB_USERNAME`	Username database	`root`
`DB_PASSWORD`	Password database	`(kosong atau password-mu)`

🔥

Fakta Menarik

Laravel menggunakan library vlucas/phpdotenv di balik layar untuk membaca file .env. Library ini secara otomatis memuat semua variabel dari .env ke dalam $_ENV dan $_SERVER PHP saat aplikasi booting — tanpa kamu perlu melakukan apa pun!

⚙️ Langkah-Langkah Setup Database Laravel Framework

Oke, teori cukup. Sekarang saatnya tangan kita kotor (secara digital, tentu saja 😄). Ikuti langkah-langkah berikut secara berurutan ya — jangan skip!

Buat Database Baru di phpMyAdmin / MySQL

Buka phpMyAdmin atau MySQL CLI-mu, lalu buat database baru. Nama database bebas — tapi gunakan huruf kecil dan underscore untuk memudahkan pengetikan.

MySQL CLI 📋 SQL

CREATE DATABASE laravel_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- Atau di phpMyAdmin: klik "New" → isi nama database → pilih utf8mb4_unicode_ci → Create

Salin File .env.example menjadi .env

Laravel tidak menyertakan file .env secara langsung di repository. Yang ada adalah .env.example sebagai template. Duplikat file ini:

Terminal / Command Prompt 📋 Bash

# Di Linux / Mac:
cp .env.example .env

# Di Windows (Command Prompt):
copy .env.example .env

Edit Konfigurasi Database di File .env

Buka file .env dengan text editor favoritmu (VS Code recommended), lalu ubah bagian konfigurasi database:

.env 📋 ENV

APP_NAME=LaravelBelajar
APP_ENV=local
APP_KEY=base64:... (akan di-generate otomatis)
APP_DEBUG=true
APP_URL=http://localhost:8000

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=root
DB_PASSWORD=# Kosong jika tidak pakai password (XAMPP default)

Generate APP_KEY

APP_KEY adalah kunci enkripsi unik untuk aplikasimu. Harus di-generate sebelum aplikasi bisa berjalan. Jalankan perintah Artisan berikut:

Terminal — di dalam folder project Laravel

$ php artisan key:generate

# Output yang akan muncul:
Application key set successfully.

Test Koneksi dengan Menjalankan Migrasi

Cara terbaik untuk memastikan konfigurasi database berhasil adalah dengan menjalankan migrasi. Laravel akan mencoba terhubung ke database dan membuat tabel default:

Terminal

$ php artisan migrate

# Jika sukses, kamu akan melihat:
  INFO  Running migrations.

  2014_10_12_000000_create_users_table ..... DONE
  2019_08_19_000000_create_failed_jobs_table . DONE
  2019_12_14_000001_create_personal_access_tokens_table DONE

💡

Tips Pro

Kalau pakai XAMPP, pastikan Apache dan MySQL sudah aktif sebelum menjalankan migrasi. Dan kalau password MySQL XAMPP kamu kosong (default), biarkan saja DB_PASSWORD= tanpa diisi apa pun di file .env.

🧪 Cara Menggunakan Variabel .env dalam Kode Laravel

Setelah setup selesai, kamu mungkin bertanya: "Gimana cara baca variabel dari .env di dalam kode Laravel?" Jawabannya: ada dua cara yang elegan.

⚖️ Dua Cara Membaca Variabel .env

🅰️ Fungsi env()

$dbName = env('DB_DATABASE');
$debug = env('APP_DEBUG', false);

Langsung baca dari file .env. Parameter kedua adalah nilai default jika variabel tidak ditemukan.

🅱️ Fungsi config() (Direkomendasikan)

$dbName = config('database.connections.mysql.database');
$appName = config('app.name');

Baca lewat file config di folder config/. Lebih stabil karena bisa di-cache oleh Laravel.

⚡

Insight Penting

Saat kamu menjalankan php artisan config:cache untuk production, Laravel akan meng-cache semua konfigurasi. Setelah itu, fungsi env() tidak akan bekerja di luar file config/*.php. Itulah kenapa menggunakan config() adalah praktik terbaik!

🚨 Error Umum dan Cara Mengatasinya dalam Mengenal Laravel Framework

Saat baru mengenal Laravel framework, kamu pasti akan bertemu error. Berikut error database paling umum dan solusinya:

❌ ERROR SQLSTATE[HY000] [2002] Connection refused

Penyebab: MySQL server belum berjalan atau DB_HOST salah.

Solusi: Pastikan MySQL aktif di XAMPP/Laragon/Homebrew. Cek lagi nilai DB_HOST di .env — biasanya 127.0.0.1.

❌ ERROR Access denied for user 'root'@'localhost'

Penyebab: Username atau password database salah di file .env.

Solusi: Cek kembali DB_USERNAME dan DB_PASSWORD. Untuk XAMPP, username default adalah root dan password kosong.

❌ ERROR No application encryption key has been specified

Penyebab: Lupa menjalankan php artisan key:generate.

Solusi: Jalankan php artisan key:generate di terminal. APP_KEY di file .env akan terisi otomatis.

⚠️

Perhatian Penting!

Setelah mengubah file .env, kamu perlu menjalankan php artisan config:clear agar Laravel memuat ulang konfigurasi terbaru. Cache konfigurasi lama bisa menyebabkan perubahan tidak terbaca!

💡

Bonus Tips: Cek Semua Konfigurasi Sekaligus

Mau cek apakah semua konfigurasi terbaca dengan benar? Gunakan Tinker!

$ php artisan tinker
>>> config('database.default')
=> "mysql"
>>> config('app.name')
=> "LaravelBelajar"

🎉

Kesimpulan: Database Tersambung, Siap Bertempur!

Sekarang kamu sudah tahu cara setup database dan konfigurasi file .env di Laravel. Inilah ringkasan yang perlu kamu ingat:

✓ File .env adalah tempat sentral semua konfigurasi sensitif — jangan pernah commit ke Git!

✓ Selalu jalankan php artisan key:generate setelah membuat file .env baru.

✓ Gunakan config() daripada env() di dalam kode untuk performa optimal.

✓ Test koneksi database dengan php artisan migrate — kalau sukses, kamu sudah siap ke langkah berikutnya!

Ini adalah bagian dari seri 50 Artikel Belajar Laravel — perjalanan kamu dalam mengenal Laravel framework secara mendalam masih panjang dan makin seru! Di artikel berikutnya kita akan menjelajahi Artisan CLI, "senjata rahasia" para developer Laravel. Jangan sampai ketinggalan!

💬 Tinggalkan Komentar 🔔 Subscribe Artikel 📤 Share Artikel

#Laravel #PHP #Database #DotEnv #MySQL #Tutorial #BelajarLaravel #MengenalLaravelFramework

📚 Navigasi Seri Belajar Laravel

← Artikel Sebelumnya

Artikel 3

Mengenal Struktur Folder Laravel Secara Lengkap

Artikel Selanjutnya →

Artikel 5

Mengenal Artisan CLI: Senjata Rahasia Laravel