Overview
File environment menyimpan nilai konfigurasi yang berbeda antara komputer developer, testing, staging, dan production. Konfigurasi yang salah dapat menyebabkan database tidak tersambung, aplikasi membaca nilai lama, atau informasi sensitif tampil di halaman error.
Artikel ini membahas peran .env, application key, konfigurasi database, cache, dan pengelolaan config cache secara aman. Tujuannya adalah membuat konfigurasi mudah direproduksi tanpa menyimpan secret ke dalam source code.
Prerequisites
- Proyek Laravel dan PHP yang memenuhi persyaratan versi.
- Composer.
- MySQL/MariaDB jika digunakan.
- Akses terminal ke direktori proyek.
- Pemahaman dasar environment variables dan konfigurasi server.
Step-by-step tutorial
1. Siapkan .env
Jika file .env belum tersedia, salin template:
cp .env.example .env
Di PowerShell:
Copy-Item .env.example .env
Jangan menimpa file environment yang telah berisi konfigurasi valid tanpa membuat backup. File .env seharusnya tidak di-commit ke repository.
2. Atur konfigurasi aplikasi
Contoh nilai untuk development:
APP_NAME="Katalog Produk"
APP_ENV=local
APP_DEBUG=true
APP_URL=http://127.0.0.1:8000
LOG_CHANNEL=stack
LOG_LEVEL=debug
APP_DEBUG=true hanya sesuai untuk local development. Pada production, gunakan APP_DEBUG=false agar detail exception, path internal, atau informasi konfigurasi tidak ditampilkan kepada pengunjung.
3. Buat application key
php artisan key:generate
Key ini digunakan oleh fitur enkripsi Laravel. Untuk aplikasi baru, command tersebut membuat key yang diperlukan. Pada aplikasi production yang sudah berjalan, jangan mengganti key secara sembarangan karena data terenkripsi dan sesi lama mungkin terdampak.
4. Konfigurasikan database
Contoh koneksi MySQL/MariaDB:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=katalog_produk
DB_USERNAME=katalog_user
DB_PASSWORD="ganti_dengan_password_kuat"
Buat database dan user dengan hak minimum yang diperlukan. Jangan menggunakan akun root sebagai credential aplikasi production. Pastikan host, port, nama database, dan password cocok dengan server yang digunakan.
5. Pilih driver cache dan session
Laravel mendukung beberapa driver sesuai konfigurasi proyek, misalnya file, database, atau Redis. Pastikan driver yang dipilih benar-benar tersedia dan telah disiapkan. Mengubah driver session di production dapat memengaruhi sesi pengguna aktif, sehingga perubahan harus direncanakan.
6. Bersihkan atau buat config cache
Saat development, bersihkan cache konfigurasi setelah mengubah nilai environment:
php artisan config:clear
Dalam proses deployment yang terkontrol, konfigurasi dapat dicache:
php artisan config:cache
Setelah konfigurasi dicache, hindari memanggil env() langsung dari kode aplikasi di luar file konfigurasi. Gunakan helper config(), misalnya config('app.name'), agar aplikasi membaca nilai dari konfigurasi yang telah dimuat.
7. Verifikasi tanpa membocorkan secret
php artisan about
php artisan migrate:status
Command yang tersedia dapat berbeda menurut versi Laravel. Jangan membagikan output log atau konfigurasi yang berisi password, token, dan API key ke issue tracker publik.
Troubleshooting
Access denied for user: periksa username, password, host account, dan hak akses database.- Perubahan
.envtidak terbaca: jalankanphp artisan config:clear, lalu periksa proses worker yang masih berjalan. - Application key tidak tersedia: untuk aplikasi baru, jalankan
php artisan key:generatedan pastikan environment yang benar digunakan. - 500 error setelah deploy: periksa log Laravel dan PHP-FPM; jangan menyalakan debug publik sebagai solusi.
- Credential production tidak berubah: periksa secret pada sistem deployment, config cache, dan proses jangka panjang.
Best practices
Jangan commit .env atau menampilkan secret di screenshot. Gunakan mekanisme secret management yang sesuai, APP_DEBUG=false pada production, dan hak database minimum. Pisahkan environment local, testing, staging, serta production. Rotasi secret harus mengikuti prosedur yang mempertimbangkan dampak terhadap data terenkripsi, sesi, dan integrasi eksternal.
Related articles
- Instalasi Laravel di Windows
- Menghubungkan Laravel dengan MySQL/MariaDB
- Mengelola Secret dan API Key
- Checklist Production Deployment
Last tested
Tanggal penyusunan: 19 Oktober 2026. Contoh konfigurasi merupakan baseline umum Laravel modern dan belum diuji pada server tertentu. Validasi harus dilakukan pada environment target sebelum deployment.