Deploy Laravel ke Shared Hosting: Panduan Lengkap & Mudah untuk Pemula

Deploy Laravel ke Shared Hosting: Panduan Lengkap & Mudah untuk Pemula
Deploy aplikasi Laravel ke shared hosting sering dianggap sulit, padahal dengan langkah yang tepat, prosesnya bisa dilakukan dengan aman dan cepat. Artikel ini akan membahas cara deploy Laravel ke shared hosting secara lengkap, mulai dari persiapan hingga aplikasi online dan siap digunakan.

Artikel ini cocok untuk pemula, pengguna cPanel, maupun yang ingin deploy Laravel tanpa VPS.

Apa Itu Shared Hosting?

Shared hosting adalah layanan hosting di mana satu server digunakan bersama oleh banyak pengguna. Biasanya shared hosting:

- Lebih murah
- Menggunakan cPanel
- Tidak memiliki akses root
- Cocok untuk website skala kecil–menengah

Laravel bisa dijalankan di shared hosting, asalkan memenuhi syarat tertentu.

Persyaratan Deploy Laravel ke Shared Hosting

Sebelum deploy, pastikan shared hosting kamu memenuhi kebutuhan Laravel:

Minimal Spesifikasi Server :
PHP 8.1+ (Laravel 10/11)

Extension PHP:
openssl
pdo
mbstring
tokenizer
xml
ctype
json
MySQL / MariaDB
Akses File Manager atau FTP
Terminal (opsional, jika tersedia)

Struktur Folder Laravel di Shared Hosting

Shared hosting biasanya hanya membaca folder: public_html
Sedangkan Laravel memiliki struktur:
/app
/bootstrap
/config
/public
/resources
/routes
/storage
/vendor

Solusinya:
Laravel core disimpan di luar public_html
Folder public Laravel diarahkan ke public_html


Langkah-Langkah Deploy Laravel ke Shared Hosting

1. Upload Project Laravel
Upload semua file Laravel ke folder di luar public_html, contoh:
/laravel-app

Gunakan:
File Manager cPanel
FTP (FileZilla)


2. Pindahkan Isi Folder public

Masuk ke folder:
laravel-app/public
Lalu copy semua isinya ke:
public_html

3. Edit File index.php
Buka file:
public_html/index.php

Ubah path berikut:
require __DIR__.'/../laravel-app/vendor/autoload.php';
$app = require_once __DIR__.'/../laravel-app/bootstrap/app.php';
Sesuaikan dengan nama folder Laravel kamu.


4. Setting File .env
Buat atau edit file .env di folder Laravel:
APP_NAME=Laravel
APP_ENV=production
APP_KEY=base64:xxxx
APP_DEBUG=false
APP_URL=https://domainkamu.com

DB_DATABASE=nama_database
DB_USERNAME=user_database
DB_PASSWORD=password_database
💡 Database bisa dibuat lewat cPanel → MySQL Database Wizard


5. Generate APP_KEY
Jika hosting memiliki terminal:
php artisan key:generate

Jika tidak, gunakan:
php artisan key:generate --show

Lalu copy hasilnya ke:
APP_KEY=


6. Setting Permission Folder
Pastikan permission:
storage → 755 / 775
bootstrap/cache → 755 / 775
Ini penting agar Laravel bisa menulis cache & log.


7. Clear Cache Laravel
Jika terminal tersedia:
php artisan optimize:clear
php artisan config:clear
php artisan cache:clear

Jika tidak, hapus manual isi folder:
storage/framework/cache
storage/framework/views
storage/framework/sessions


Mengatasi Error Umum Saat Deploy Laravel
500 Internal Server Error

Cek permission folder
Pastikan .env benar
Nonaktifkan APP_DEBUG di production

Error Storage Not Writable
Solusi:
chmod -R 775 storage bootstrap/cache


Route Tidak Terbaca
Tambahkan di .htaccess:
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^ index.php [L]
</IfModule>


Tips Optimasi Laravel di Shared Hosting :

Gunakan cache config & route
Matikan APP_DEBUG
Gunakan hosting dengan LiteSpeed
Aktifkan OPcache jika tersedia
Gunakan Cloudflare untuk CDN & SSL