Aplikasi Laravel.
Yang langsung didapat proyek Laravel: APP_KEY dan pengaturan production, SQLite hingga Anda menambahkan database, migrasi sebagai release command, queue worker, dan scheduler.
Laravel dikenali dari laravel/framework di composer.json. Anda men-deploy-nya apa adanya — tanpa konfigurasi server, tanpa file tambahan di repository.
Cara build dan menjalankannya
- PHP — versi terendah dari 8.2, 8.3, dan 8.4 yang memenuhi persyaratan
phpdicomposer.json(8.3 jika tidak disebutkan). - Composer —
composer install --no-dev --optimize-autoloader. - Aset front-end — jika
package.jsonmemiliki scriptbuild(Vite), script tersebut dijalankan danpublic/builddisertakan. - Saat start —
storage:link, lalu cache config, route, dan view dibuat. - HTTPS — aplikasi Anda melihat permintaan HTTPS sebagai aman, sehingga
url(),asset(), dan redirect menggunakanhttps://tanpa perlu Anda mengatur trusted proxy sendiri.
Variabel yang diatur untuk Anda
| Variabel | Nilai |
|---|---|
APP_KEY | dibuat sekali pada deploy pertama dan disimpan bersama variabel Anda |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | alamat aplikasi |
LOG_CHANNEL | stderr — agar tab Log menampilkan log Laravel |
SESSION_DRIVER, CACHE_STORE | redis jika aplikasi memiliki Valkey, jika tidak file |
Masing-masing dapat diganti dengan variabel Anda sendiri bernama sama — misalnya SESSION_DRIVER=database. Lihat Variabel lingkungan.
Database: SQLite lebih dulu
Aplikasi Laravel baru tanpa database menyimpan datanya di SQLite — bawaan Laravel sendiri — di storage/app/database.sqlite pada disk aplikasi. File ini tetap ada setelah deploy dan ikut dalam backup harian aplikasi, sehingga Anda bisa meluncurkan lebih dulu dan memilih database nanti.
Saat Anda menambahkan PostgreSQL atau MySQL ke proyek (Ringkasan → Service → Tambah service), aplikasi beralih ke database tersebut pada deploy berikutnya, dan migrasi dijalankan di sana. Data di file SQLite tidak dipindahkan — ekspor lebih dulu jika Anda membutuhkannya, lalu impor di tab Data milik database. Lihat Database.
Migrasi — release command
Release command yang disarankan adalah php artisan migrate --force. Perintah ini berjalan sekali di setiap deploy, sebelum versi baru menerima pengunjung; jika migrasi gagal, versi saat ini tetap berjalan. Anda dapat mengubahnya di tab Proses. Lihat Deploy.
Queue worker dan scheduler
Secara bawaan, tab Proses menjalankan:
| Apa | Perintah |
|---|---|
| Background worker «queue» | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Perintah terjadwal, setiap menit | php artisan schedule:run |
Keduanya berbagi resource aplikasi dan restart di setiap deploy. Ubah atau hapus di tab Proses — misalnya, ganti worker dengan php artisan horizon jika Anda menggunakan Horizon dengan Valkey.
Untuk antrean yang berat, jalankan worker sebagai service background worker terpisah dengan resource sendiri, lalu hapus dari Proses. Lihat Service dalam proyek.
Valkey untuk cache, sesi, dan antrean
Tambahkan Valkey ke proyek: sesi dan cache otomatis pindah ke sana (pada deploy berikutnya; pengunjung perlu masuk sekali lagi). Antrean dan pengaturan lainnya Anda atur di tab Variabel, misalnya:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT, dan REDIS_CLIENT=phpredis sudah diatur untuk Anda.
WebSocket (Laravel Reverb)
Jalankan Reverb sebagai web service dari kode proyek ini dengan perintah php artisan reverb:start --host=0.0.0.0 --port=$PORT. Service ini mendapat alamatnya sendiri.
File dan upload
File di storage/app — disk local dan public milik Laravel — tetap berada di disk aplikasi di antara deploy dan di-backup setiap hari. Semua isi folder proyek lainnya diambil baru dari repository di setiap deploy. Untuk file yang banyak atau besar, gunakan object storage dengan disk s3 milik Laravel.