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

Blog / Umum / Panduan Konfigurasi Environmen...
Umum

Panduan Konfigurasi Environment Laravel: .env, Database, Cache, dan Application Key

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
3 min read
20 views

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 .env tidak terbaca: jalankan php artisan config:clear, lalu periksa proses worker yang masih berjalan.
  • Application key tidak tersedia: untuk aplikasi baru, jalankan php artisan key:generate dan 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

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.

Bagikan artikel:

Artikel lainnya

Cari Artikel