Konfigurasi .env
RingkasnyaBerkas .env menyimpan pengaturan server Pondok CMS. Yang wajib diisi adalah APP_URL, DB_DATABASE, DB_USERNAME, DB_PASSWORD, dan akun super-admin; kunci lain cukup diisi bila kondisi hosting Anda membutuhkannya.
Daftar isi
Berkas .env berada di root aplikasi, misalnya /home/akun/pondok/.env. Templatnya .env.production.example, dan pondok:install menyalinnya menjadi .env bila berkas itu belum ada.
Buka .env lewat File Manager dengan opsi Show Hidden Files aktif.
.env berisi password database dan email. Berkas ini harus berada di luar public_html. Jangan pernah membagikan isinya atau memasukkannya ke Git.
Kunci .env apa yang perlu diisi? Tautan ke bagian Kunci .env apa yang perlu diisi?
| Kunci | Wajib? | Contoh | Keterangan |
|---|---|---|---|
APP_URL | Ya | https://pondok.sch.id | Alamat situs persis seperti yang dibuka pengunjung, termasuk https://. Dipakai QR surat dan gambar portal. |
APP_ENV | Ya | production | Biarkan production. |
APP_DEBUG | Ya | false | Biarkan false agar detail error tidak tampil ke pengunjung. |
APP_KEY | Ya | (dibuat otomatis) | Diisi oleh pondok:install. Jangan diubah setelah ada data. |
DB_HOST | Ya | localhost | Biasanya localhost di cPanel. |
DB_DATABASE | Ya | akun_pondok | Nama database yang dibuat di MySQL Databases. |
DB_USERNAME | Ya | akun_pondok | User database. |
DB_PASSWORD | Ya | Password user database. | |
SUPER_ADMIN_NAME | Saat instalasi | "Super Admin" | Nama akun pertama. |
SUPER_ADMIN_EMAIL | Saat instalasi | admin@pondok.sch.id | Email untuk login pertama. |
SUPER_ADMIN_PASSWORD | Saat instalasi | Minimal 8 karakter. Hapus nilainya setelah berhasil login. | |
MAIL_HOST | Disarankan | mail.pondok.sch.id | Server SMTP akun email cPanel atau layanan lain. |
MAIL_PORT | Disarankan | 465 | Port SMTP. |
MAIL_USERNAME | Disarankan | admin@pondok.sch.id | Akun email pengirim. |
MAIL_PASSWORD | Disarankan | Password akun email. | |
MAIL_FROM_ADDRESS | Disarankan | "admin@pondok.sch.id" | Alamat pengirim email. |
MAIL_FROM_NAME | Tidak | "${APP_NAME}" | Nama pengirim. Bawaan mengikuti APP_NAME. |
TRUSTED_PROXIES | Tidak | * | Hanya bila situs di belakang Cloudflare atau proxy lain. Daftar IP atau CIDR dipisah koma, atau *. |
PONDOK_PUBLIC_PATH | Tidak | /home/akun/public_html | Hanya untuk cara B. |
PUBLIC_STORAGE_ROOT | Tidak | /home/akun/pondok/public/storage | Hanya bila hosting mematikan symlink. |
DEMO_PASSWORD | Tidak | Untuk data demo. Biarkan kosong di produksi. Lihat Data demo. |
Apa catatan untuk tiap kelompok kunci? Tautan ke bagian Apa catatan untuk tiap kelompok kunci?
APP_URL Tautan ke bagian APP_URL
Bila APP_URL tidak sama dengan alamat situs, QR pada surat dan gambar di portal tidak berfungsi. Setelah AutoSSL aktif, pastikan nilainya memakai https://.
Akun super-admin Tautan ke bagian Akun super-admin
SUPER_ADMIN_* hanya dibaca saat pondok:install membuat akun pertama. Menjalankan ulang instalasi tidak mengubah password akun yang sudah ada. Setelah login berhasil, kosongkan SUPER_ADMIN_PASSWORD.
Email (MAIL_*) Tautan ke bagian Email (MAIL_*)
Isi pengaturan SMTP akun email cPanel agar email benar-benar terkirim. Email dikirim lewat antrean, jadi cron schedule:run juga harus berjalan. Lihat Cron dan antrean.
Proxy tepercaya Tautan ke bagian Proxy tepercaya
Isi TRUSTED_PROXIES hanya bila situs berada di belakang Cloudflare atau proxy lain. Lihat HTTPS dan pemeriksaan.
Kunci lain apa yang ada di templat? Tautan ke bagian Kunci lain apa yang ada di templat?
Templat .env.production.example juga berisi kunci berikut. Biarkan nilai bawaannya kecuali Anda tahu alasan mengubahnya.
| Kunci | Nilai bawaan | Keterangan |
|---|---|---|
APP_NAME | Pondok CMS | Nama aplikasi. |
APP_LOCALE, APP_FALLBACK_LOCALE, APP_FAKER_LOCALE | id, en, id_ID | Bahasa aplikasi. |
APP_MAINTENANCE_DRIVER | file | Penyimpanan status mode pemeliharaan. |
BCRYPT_ROUNDS | 12 | Kekuatan hash password. |
LOG_CHANNEL, LOG_STACK, LOG_LEVEL | stack, single, error | Pencatatan log di storage/logs. |
DB_CONNECTION, DB_PORT | mysql, 3306 | Jenis dan port database. |
SESSION_DRIVER | database | Sesi disimpan di database. |
SESSION_ENCRYPT, SESSION_SECURE_COOKIE | true, true | Sesi terenkripsi dan cookie hanya lewat HTTPS. |
SESSION_LIFETIME | 120 | Lama sesi dalam menit. |
QUEUE_CONNECTION | database | Antrean memakai database. |
CACHE_STORE | database | Cache memakai database. |
FILESYSTEM_DISK | local | Disk penyimpanan bawaan. |
MAIL_MAILER, MAIL_SCHEME | smtp, null | Pengiriman email lewat SMTP. |
Bila Anda pernah menjalankan php artisan optimize, konfigurasi ter-cache. Jalankan php artisan optimize:clear setelah mengubah .env.