Dokumentasi Deploy Framework Laravel

Cara Hosting Aplikasi Laravel

Hostifame dirancang untuk menjadi "Rumah" paling sempurna bagi ekosistem Laravel. Mesin CI/CD kami akan mengambil alih seluruh tugas berat infrastruktur, sehingga Anda bisa fokus pada kode (Zero-Config Deployment).


1. Persiapkan File Proyek (.ZIP) & Aturan Wajib

Untuk memastikan proses upload berjalan sangat cepat dan tidak mengalami kegagalan (timeout), Anda hanya perlu mengunggah Source Code murni dari proyek Laravel Anda.

Benar & Cepat

Apa yang Harus Di-ZIP?

Kompres seluruh direktori kodingan proyek Laravel Anda seperti folder app, config, database, public, resources, routes, serta file composer.json dan package.json.

Ukuran Ringan: Tanpa folder dependensi lokal, ukuran file ZIP Anda umumnya hanya sekitar 2 - 5 MB sehingga upload selesai dalam hitungan detik!
Dilarang Keras

Jangan Sertakan Folder Ini!

Pastikan Anda TIDAK MENGIKUTSERTAKAN folder-folder di bawah ini ke dalam file .ZIP Anda:

  • ❌ /vendor (Ratusan megabyte library PHP)
  • ❌ /node_modules (Library JS / Vite frontend)
Menyertakan folder ini akan membuat file ZIP bengkak hingga ratusan MB dan menyebabkan proses upload gagal. Mesin server kami akan menginstal dependensi tersebut secara otomatis!

2. Isi Formulir Proyek & Database Otomatis

Masuk ke Dasbor Hostifame dan klik tombol Tambah Proyek. Pada formulir yang muncul:

  • Pilih file ZIP Laravel Anda.
  • File SQL (Opsional): Unggah file .sql jika Anda memiliki data awal (dump database).
  • Database: Tentukan Nama dan Password Database. Sistem akan membuatkan database MySQL secara otomatis.
  • Sistem akan melakukan CI Analysis kilat. Setelah tervalidasi sebagai proyek Laravel, klik tombol Deploy.

3. Sihir Otomatisasi (Di Belakang Layar)

Begitu Anda mengklik "Deploy", Agen Server Hostifame akan bekerja secara otomatis. Anda tidak perlu repot mengetik perintah terminal:

Kompilasi Penuh Menjalankan composer install dan npm run build.
Injeksi .ENV Pintar Menyuntikkan kredensial database dan memaksa mode Production.
Setup Storage & Key Mengeksekusi key:generate dan storage:link.
Migrasi & Seeding Menjalankan migrate --force dan db:seed --force.

4. Konfigurasi Environment Lanjutan

Hostifame secara otomatis menyiapkan file .env untuk Anda. Jika proyek Anda membutuhkan integrasi pihak ketiga (seperti API Key, SMTP Email, dll), Anda dapat menambahkannya melalui menu Web File Manager dengan mengedit file .env secara langsung.

.env
# Bagian di bawah ini diisi OTOMATIS oleh Mesin Hostifame
APP_NAME="Proyek Laravel Saya"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://nama-proyek.hostifame.id

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=db_namaprojekanda
DB_USERNAME=user_namaanda
DB_PASSWORD="password_rahasia_anda"

# Tambahkan kredensial eksternal Anda di baris bawah sini:
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io

5. Manajemen via Fitur Pengembang Cepat

Jika Anda membutuhkan eksekusi perintah php artisan di kemudian hari, Anda dapat menggunakan tombol Pengembangan Cepat yang ada di halaman File Manager proyek Anda. Anda dapat melakukan clear cache, migrasi database, hingga storage link cukup dengan satu klik!

Fitur Keamanan Otomatis: Production Mode

Sistem Hostifame secara default akan memaksa pengaturan APP_DEBUG=false dan APP_ENV=production pada saat proses instalasi (Deploy). Ini akan mencegah kebocoran informasi sensitif jika terjadi error pada aplikasi. Jika Anda perlu mengubah nilai ini untuk debugging, pastikan Anda mengklik tombol "Clear Cache" di menu Pengembangan Cepat setiap kali Anda mengubah file .env!