Deploy Laravel di shared hosting cPanel tanpa drama (dan tanpa upload folder vendor lewat FTP)

Sugeng siang gan. Banyak klien saya koperasi dan toko kecil, budget hosting mereka 30-50 ribu sebulan, jadi VPS belum masuk akal. Ini langkah yang saya pakai sejak 2019 untuk deploy Laravel di shared hosting cPanel. Sudah dipakai di 20an klien, aman.

1. Struktur folder

Jangan taruh semua isi project di public_html. Folder .env, vendor, storage jadi bisa diakses dari browser. Taruh project di luar:

/home/userkoperasi/laravel-app      <- seluruh project
/home/userkoperasi/public_html      <- hanya isi folder public

Kalau cPanel punya menu Terminal (sekarang kebanyakan sudah ada), paling bersih pakai symlink:

cd ~
mv public_html public_html_lama
ln -s ~/laravel-app/public ~/public_html

Kalau tidak bisa symlink, copy isi folder public ke public_html, lalu edit dua baris di public_html/index.php:

require __DIR__.'/../laravel-app/vendor/autoload.php';
$app = require_once __DIR__.'/../laravel-app/bootstrap/app.php';

2. Composer, bukan FileZilla

Folder vendor itu 20 ribu file lebih. Upload lewat FTP bisa 2 jam dan pasti ada yang gagal. Banyak cPanel sudah ada composer, kalau tidak ada pakai composer.phar:

cd ~/laravel-app
php composer.phar install --no-dev --optimize-autoloader

3. Versi PHP dan extension

Di menu "Select PHP Version" atau MultiPHP Manager pilih 8.2 ke atas. Centang extension: pdo_mysql, mbstring, openssl, fileinfo, bcmath. Hati-hati: PHP di browser dan PHP di terminal/cron bisa beda versi. Selalu cek php -v di terminal.

4. File .env

APP_ENV=production
APP_DEBUG=false
APP_URL=https://koperasimaju.id

APP_DEBUG=false. Saya tulis tebal karena pernah lihat website klien orang lain yang error page-nya menampilkan password database ke seluruh internet. Lalu:

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

Beberapa hosting mematikan fungsi symlink() di PHP, jadi storage:link gagal. Buat manual dari terminal: ln -s ~/laravel-app/storage/app/public ~/public_html/storage.

5. Cron untuk scheduler

Di menu Cron Jobs cPanel, tambahkan satu baris tiap menit. Path PHP harus lengkap, dan sering beda dengan /usr/bin/php. Di server EasyApache biasanya seperti ini:

* * * * * cd /home/userkoperasi/laravel-app && /opt/cpanel/ea-php82/root/usr/bin/php artisan schedule:run >> /dev/null 2>&1

6. Queue tanpa Supervisor

Shared hosting tidak ada Supervisor. Untuk job kecil (email, PDF struk) saya jalankan worker dari scheduler, berhenti kalau queue kosong:

// routes/console.php
Schedule::command('queue:work --stop-when-empty --max-time=50')
    ->everyMinute()
    ->withoutOverlapping();

Pakai QUEUE_CONNECTION=database karena shared hosting jarang ada Redis.

7. Permission

storage dan bootstrap/cache harus bisa ditulis (775). Kalau muncul error 500 tanpa pesan, 80% masalahnya di sini, sisanya .env salah wkwkwk.

Terakhir: shared hosting itu untuk mulai, bukan untuk selamanya. Kalau transaksi klien sudah lebih dari 200 per hari atau butuh Redis, saatnya pindah VPS. Monggo kalau ada pertanyaan 🙏