Panduan ini untuk aplikasi Laravel (mis. backend CMS atau API) yang di-deploy ke hosting cPanel Hostcloud dengan MySQL.

Yang perlu disiapkan

Paket hosting aktif dengan akses SSH dan PHP 8.2+
Domain yang sudah diarahkan ke hosting (lihat tutorial pointing domain)
Kode aplikasi di Git atau berkas ZIP

1. Atur versi PHP

Di cPanel buka MultiPHP Manager, pilih domain, lalu atur ke PHP 8.2 atau lebih baru. Pastikan ekstensi mbstring, pdo_mysql, openssl, fileinfo, dan intl aktif di Select PHP Version.

2. Buat database MySQL

Buka MySQL Databases, buat database baru.
Buat pengguna dengan kata sandi kuat, lalu tambahkan ke database dengan All Privileges.
Catat nama database, pengguna, dan kata sandi.

3. Unggah kode

Lewat SSH:

cd ~
git clone git@github.com:perusahaan/aplikasi.git app
cd app
composer install --no-dev --optimize-autoloader

Letakkan folder aplikasi di luar public_html, lalu arahkan document root domain ke folder public aplikasi (cPanel → Domains → ubah Document Root).

4. Konfigurasi .env

cp .env.example .env
php artisan key:generate

Edit .env:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://namadomain.com
DB_DATABASE=cpuser_app
DB_USERNAME=cpuser_app
DB_PASSWORD=********

5. Migrasi dan optimasi

php artisan migrate --force
php artisan storage:link
php artisan config:cache && php artisan route:cache && php artisan view:cache

6. Cron untuk scheduler dan queue

Tambahkan di Cron Jobs:

* * * * * cd /home/cpuser/app && php artisan schedule:run >> /dev/null 2>&1

Pemecahan masalah

Error 500 — periksa storage/logs/laravel.log dan izin folder storage serta bootstrap/cache (775).
Halaman 404 selain beranda — pastikan document root mengarah ke folder public.
Gambar tidak tampil — jalankan ulang php artisan storage:link.