Cara Install Laravel di Shared Hosting Indonesia Tanpa Ribet

Cara install laravel di shared hosting indonesia sering jadi pertanyaan banyak developer pemula yang ingin menjalankan project langsung dari server. Laravel memang framework PHP modern yang butuh konfigurasi khusus, tapi bukan berarti mustahil dipasang di shared hosting. Banyak provider lokal seperti Niagahoster, DomaiNesia, dan Rumahweb sudah mendukung kebutuhan teknis Laravel secara penuh. Kamu hanya perlu memahami langkah yang tepat agar aplikasi berjalan mulus tanpa error 500.

Persiapan Sebelum Install

Sebelum mulai, pastikan shared hosting kamu memenuhi syarat minimum Laravel. Versi PHP harus 8.1 atau lebih tinggi untuk Laravel 10, sementara Laravel 11 butuh PHP 8.2 ke atas. Selain itu, ekstensi PHP seperti mbstring, openssl, pdo_mysql, dan xml harus aktif. Kamu bisa cek ini lewat menu Select PHP Version di cPanel. Kalau bingung, langsung tanyakan ke layanan support hosting karena setiap provider punya tata letak cPanel yang sedikit berbeda.

Kamu juga butuh akses ke File Manager dan MySQL Database Wizard. Sebagian besar shared hosting Indonesia sudah menyediakan fitur ini secara default. Kalau hosting kamu belum punya Composer di server, solusinya adalah install dependency Laravel di komputer lokal terlebih dahulu. Nanti folder vendor yang sudah lengkap ikut kamu upload bersama file project lainnya.

Metode Upload Project Laravel ke cPanel

Ada beberapa cara untuk memindahkan project Laravel dari lokal ke shared hosting. Masing-masing punya kelebihan tergantung akses yang kamu miliki dan besar project.

1. Upload Manual Melalui File Manager

Cara paling umum adalah membuat file ZIP dari project Laravel lokal, lalu upload via File Manager cPanel. Pastikan kamu sudah jalankan perintah php artisan config:cache dan php artisan route:cache di lokal agar aplikasi lebih cepat saat diakses nanti. Menurut Course Net, kamu perlu mengekstrak file ZIP di folder root atau di luar public_html demi keamanan. Jangan lupa pindahkan isi folder public Laravel ke dalam public_html agar domain bisa mengakses entry point aplikasi dengan benar.

2. Menggunakan Git Clone

Kalau hosting kamu menyediakan akses terminal atau SSH, prosesnya jauh lebih praktis. Kamu bisa langsung clone repository dari GitHub ke server, lalu jalankan composer install untuk mengunduh dependency. Menurut 2MHost, metode ini lebih cepat karena tidak perlu upload file satu per satu. Setelah clone selesai, buat symbolic link dari public_html ke folder public project Laravel agar struktur direktori tetap aman.

3. Deploy dengan Softaculous

Beberapa shared hosting dilengkapi Softaculous Apps Installer yang menyediakan instalasi Laravel otomatis. Menurut Libyan Spider, kamu tinggal cari Laravel di kolom pencarian Softaculous, klik Install, lalu ikuti panduan pengisian domain dan direktori. Metode ini cocok untuk pemula yang belum familiar dengan konfigurasi manual meskipun versi Laravel yang tersedia terkadang tidak yang paling baru.

Konfigurasi Folder dan File Penting

Setelah file berhasil diupload, langkah paling krusial adalah mengatur agar domain mengarah ke folder public Laravel. Secara default, Laravel menyimpan file index.php di dalam folder public, sedangkan cPanel menggunakan public_html sebagai root domain.

1. Mengatur Symbolic Link

Kalau hosting mendukung symlink, hapus folder public_html lama lalu buat symbolic link yang menunjuk ke folder public project Laravel. Perintahnya adalah ln -s /home/username/project-laravel/public /home/username/public_html. Cara ini direkomendasikan Quape karena lebih bersih dan aman dari segi struktur folder. File sensitif seperti.env tetap berada di luar jangkauan publik.

2. Edit File index.php Secara Manual

Kalau symlink tidak didukung, solusinya adalah mengedit file index.php yang ada di public_html. Ubah baris require autoload dan bootstrap agar menunjuk ke folder project Laravel yang berada satu tingkat di atas public_html. Menurut Stack Overflow, banyak developer Indonesia yang berhasil dengan metode ini meskipun sedikit lebih repot saat maintenance.

Setup Database dan Environment

Aplikasi Laravel tidak akan berjalan tanpa koneksi database yang tepat. Buat database baru lewat MySQL Database Wizard di cPanel, lalu buat user dan berikan hak akses penuh. Catat nama database, username, dan password karena nanti dimasukkan ke file .env.

1. Mengatur File .env

File .env adalah jantung konfigurasi Laravel. Salin file .env.example menjadi.env melalui File Manager, lalu edit beberapa baris penting. Ubah APP_URL sesuai domain kamu, APP_ENV menjadi production, dan APP_DEBUG menjadi false agar error tidak ditampilkan ke pengunjung. Bagian paling penting adalah konfigurasi DB_HOST, DB_DATABASE, DB_USERNAME, dan DB_PASSWORD yang harus sesuai dengan database yang baru dibuat.

2. Migrasi Database

Kalau hosting menyediakan akses terminal, jalankan php artisan migrate untuk membuat tabel otomatis. Kalau tidak ada akses SSH, solusinya adalah export database dari phpMyAdmin lokal lalu import ke phpMyAdmin cPanel. Menurut Truehost, cara ini sama efektifnya asalkan struktur tabel dan data sudah benar di komputer lokal.

Perbandingan Metode Deploy Laravel

Setiap metode deploy Laravel ke shared hosting punya kelebihan dan kekurangan masing-masing. Pilihan terbaik tergantung pada tingkat keahlian teknismu, fitur yang disediakan hosting, dan seberapa sering kamu perlu update project. Ada kalanya upload manual lebih aman meskipun lambat, tapi ada juga situasi di mana git clone jauh lebih efisien. Di bawah ini kita lihat perbandingan tiga metode populer yang sering digunakan developer Indonesia.

Pertanyaan Terkait

Banyak pertanyaan muncul saat pertama kali deploy Laravel ke shared hosting. Berikut beberapa yang paling sering ditanyakan developer Indonesia.

1. Apakah Semua Shared Hosting Bisa Install Laravel?

Tidak semua shared hosting cocok untuk Laravel. Pastikan provider mendukung PHP 8.1 atau lebih tinggi serta ekstensi yang dibutuhkan. Hosting Indonesia seperti Niagahoster dan DomaiNesia umumnya sudah memenuhi syarat ini. Kalau ragu, tanyakan langsung ke support mereka sebelum berlangganan.

2. Mengapa Muncul Error 500 Setelah Upload?

Error 500 biasanya disebabkan permission folder yang salah atau file .htaccess yang tidak terupload. Pastikan folder memiliki permission 755 dan file memiliki permission 644. Selain itu, cek apakah file .env sudah dikonfigurasi dengan benar dan APP_KEY sudah digenerate.

3. Bagaimana Kalau Tidak Punya Akses SSH?

Tidak masalah. Kamu bisa upload seluruh project termasuk folder vendor yang sudah diinstall di lokal. Meskipun ukuran file lebih besar, aplikasi tetap bisa berjalan normal. Menurut pengalaman banyak developer di forum Stack Overflow, metode ini adalah solusi paling praktis untuk shared hosting tanpa SSH.

Tips Optimasi Laravel di Shared Hosting

Setelah berhasil install, jangan lupa optimasi agar website tetap cepat dan aman. Aktifkan cache konfigurasi, rute, dan view melalui terminal jika memungkinkan. Kalau tidak ada akses SSH, kamu bisa jalankan perintah tersebut di lokal sebelum upload. Selalu gunakan HTTPS jika tersedia dan jangan lupa blok akses ke file .env lewat.htaccess untuk mencegah kebocoran data sensitif.

Kesimpulan

Cara install laravel di shared hosting indonesia memang butuh ketelitian, tapi hasilnya sepadan dengan usaha yang dikeluarkan. Mulai dari persiapan PHP version, upload file, konfigurasi folder public, hingga setup database, semua langkah harus dilakukan berurutan. Pilih metode deploy yang paling sesuai dengan kemampuan dan fitur hosting yang kamu miliki. Kalau mengalami kendala, jangan ragu bertanya ke komunitas Laravel Indonesia atau support hosting provider karena banyak masalah umum yang sudah punya solusi standar.