Mulai sekarang

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.

3 MENIT BACA

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 php di composer.json (8.3 jika tidak disebutkan).
  • Composer — composer install --no-dev --optimize-autoloader.
  • Aset front-end — jika package.json memiliki script build (Vite), script tersebut dijalankan dan public/build disertakan.
  • Saat start — storage:link, lalu cache config, route, dan view dibuat.
  • HTTPS — aplikasi Anda melihat permintaan HTTPS sebagai aman, sehingga url(), asset(), dan redirect menggunakan https:// tanpa perlu Anda mengatur trusted proxy sendiri.

Variabel yang diatur untuk Anda

VariabelNilai
APP_KEYdibuat sekali pada deploy pertama dan disimpan bersama variabel Anda
APP_ENVproduction
APP_DEBUGfalse
APP_URLalamat aplikasi
LOG_CHANNELstderr — agar tab Log menampilkan log Laravel
SESSION_DRIVER, CACHE_STOREredis 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:

ApaPerintah
Background worker «queue»php artisan queue:work --sleep=3 --tries=3 --max-time=3600
Perintah terjadwal, setiap menitphp 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=redis

REDIS_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.

Masih ada kendala?

Chat dengan kami — AI langsung menjawab dan engineer bergabung bila diperlukan, kapan saja.

Hubungi dukungan