Panduan Praktis Konfigurasi ENV Laravel: Dev ke Production

Pendahuluan

Bayangin lagi ngerjain fitur sederhana, tapi aplikasi malah error di server gara-gara variabel environment yang tertinggal atau beda konfigurasi antara lokal sama production. Pengalaman ini sering banget bikin frustrasi karena nge-debug `.env` itu kayak nyari jarum dalam jerami kalau kita nggak punya pola yang rapi dari awal.

Tips & Best Practices

Di banyak project, biasanya saya mulai dari membuat file .env.example yang lengkap supaya tim lain nggak bingung pas nge-clone repo. Jangan pernah anggap remeh dokumentasi variabel ini karena ini adalah nyawa aplikasi kita. Berikutnya, saya selalu biasakan pakai fungsi env() dengan nilai default agar aplikasi nggak langsung crash saat ada konfigurasi yang lupa di-set. Terakhir, pisahkan credential sensitif menggunakan layanan pihak ketiga seperti AWS Secrets Manager atau HashiCorp Vault kalau project-nya udah level enterprise, jadi nggak semua orang punya akses ke file .env produksi.

Contoh Kode

Biasanya saya selalu pasang fallback value di file config agar kode tetap jalan meski ada variabel yang kelupaan:

// config/database.php
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '3306'),
'database' => env('DB_DATABASE', 'laravel_db'),

Variasi Implementasi

Ada dua pendekatan yang sering saya pakai. Pertama, pakai file .env lokal yang gampang diubah-ubah pas lagi ngoding. Kedua, pakai pendekatan $_SERVER atau getenv() langsung di server production lewat panel kontrol seperti Forge atau Vapor untuk menghindari akses file fisik yang berisiko bocor kalau konfigurasi web server salah.

Kesalahan Umum

1. Lupa nge-commit `.env.example` ke git, akhirnya rekan kerja lain harus tebak-tebakan variabel apa yang kurang. 2. Nyimpen rahasia sensitif seperti API Key langsung di dalam file `config/*.php` tanpa lewat `.env`. 3. Lupa nge-run php artisan config:cache di server, yang bikin perubahan environment jadi nggak kedetek. 4. Pakai nilai `APP_DEBUG=true` di server produksi, yang bikin error stack trace malah jadi pintu masuk hacker. 5. Copy-paste `.env` lokal langsung ke server tanpa filter, jadinya koneksi database-nya masih ngarah ke localhost di laptop sendiri.

Ringkasan

Mengelola environment itu bukan cuma soal teknis, tapi soal disiplin. Kalau kita rapi dari awal, urusan deployment jadi jauh lebih tenang. Pada akhirnya, `.env` itu bukan cuma file teks, tapi peta keamanan aplikasi kita yang harus dijaga dan dirawat biar nggak jadi bom waktu di masa depan.