Cara Deploy Laravel ke Shared Hosting cPanel (Langkah demi Langkah)
Setelah selesai mengembangkan aplikasi Laravel di komputer lokal, langkah berikutnya adalah men-deploy-nya agar bisa diakses secara online. Banyak developer pemula mengira Laravel hanya bisa dijalankan di VPS, padahal aplikasi Laravel juga bisa berjalan di shared hosting berbasis cPanel dengan penyesuaian tertentu. Artikel ini akan memandu Anda melakukan deploy Laravel ke shared hosting secara bertahap.
Persiapan Sebelum Deploy
Sebelum memulai, pastikan hosting Anda memenuhi persyaratan minimum Laravel. Periksa versi PHP yang tersedia karena Laravel modern membutuhkan versi PHP tertentu. Pastikan juga ekstensi PHP yang dibutuhkan Laravel sudah aktif, dan hosting mendukung database MySQL. Sebagian besar shared hosting modern sudah memenuhi syarat ini, tetapi tetap penting untuk memeriksanya terlebih dahulu agar tidak menemui kendala di tengah proses.
Selain itu, siapkan beberapa hal berikut: file project Laravel Anda, file database hasil export dari phpMyAdmin lokal, serta akses ke cPanel hosting. Dengan persiapan yang matang, proses deploy akan berjalan jauh lebih lancar dan Anda terhindar dari kebingungan di tengah jalan.
Langkah 1: Menyiapkan File Project
Tantangan utama deploy Laravel ke shared hosting adalah struktur folder. Secara default, Laravel dirancang agar folder public menjadi root website, sedangkan file lainnya berada di luar akses publik demi keamanan. Namun, shared hosting biasanya menjadikan folder public_html sebagai root. Karena itu, Anda perlu menyesuaikan strukturnya.
Pendekatan yang umum adalah menempatkan seluruh file Laravel di folder di luar public_html, lalu memindahkan isi folder public ke dalam public_html. Setelah itu, sesuaikan path pada file index.php di public_html agar menunjuk ke lokasi file Laravel yang benar. Penyesuaian ini adalah inti dari proses deploy Laravel ke shared hosting.
Langkah 2: Upload File ke Hosting
Untuk mengunggah file, kompres project Laravel Anda menjadi file zip terlebih dahulu agar proses upload lebih cepat dan praktis. Kemudian gunakan File Manager di cPanel untuk mengunggahnya, atau manfaatkan FTP seperti FileZilla untuk project berukuran besar. Setelah terunggah, ekstrak file zip di lokasi yang sesuai dengan struktur yang telah direncanakan.
Perlu diperhatikan, folder vendor yang berisi dependency Laravel berukuran cukup besar. Anda bisa mengunggahnya bersama project, atau menjalankan composer install langsung di server jika hosting mendukung akses terminal. Bagi kebanyakan shared hosting, mengunggah folder vendor bersama project adalah cara paling sederhana.
Langkah 3: Mengatur Database
Aplikasi Laravel umumnya membutuhkan database. Di cPanel, buat database MySQL baru beserta user-nya, lalu hubungkan keduanya. Setelah itu, buka phpMyAdmin dan import file database yang telah Anda export dari lokal. Proses ini memindahkan seluruh struktur dan data aplikasi Anda ke server.
Setelah database siap, jangan lupa memperbarui konfigurasi koneksi. Ini akan kita lakukan pada langkah berikutnya melalui file konfigurasi Laravel, agar aplikasi tahu cara terhubung ke database yang baru dibuat di server.
Langkah 4: Mengatur File .env
File .env adalah pusat konfigurasi Laravel. Setelah deploy, Anda perlu menyesuaikan beberapa pengaturan penting agar aplikasi berjalan dengan benar di server. Sesuaikan konfigurasi database dan mode aplikasi seperti berikut:
APP_ENV=production
APP_DEBUG=false
APP_URL=https://domainanda.com
DB_DATABASE=namauser_namadb
DB_USERNAME=namauser_dbuser
DB_PASSWORD=password_databasePerhatikan bahwa APP_DEBUG sebaiknya diatur menjadi false di lingkungan produksi. Ini penting untuk keamanan, agar detail error tidak ditampilkan kepada pengunjung. Sesuaikan juga kredensial database dengan yang telah Anda buat di cPanel sebelumnya.
Langkah 5: Menyelesaikan Konfigurasi Akhir
Setelah semua terpasang, ada beberapa langkah penyelesaian. Pastikan APP_KEY sudah terisi; jika belum, Anda perlu men-generate-nya. Atur juga permission folder storage dan bootstrap/cache agar dapat ditulis oleh server. Terakhir, bersihkan cache konfigurasi agar pengaturan baru terbaca dengan benar. Setelah itu, buka domain Anda di browser untuk menguji apakah aplikasi sudah berjalan.
Mengatasi Masalah Umum Saat Deploy
Beberapa masalah sering muncul saat deploy Laravel ke shared hosting. Error 500 biasanya berkaitan dengan permission folder atau APP_KEY yang belum diset. Halaman blank sering disebabkan path yang salah pada index.php. Error database menandakan kredensial di file .env belum sesuai. Dengan memeriksa hal-hal ini secara sistematis, sebagian besar masalah deploy bisa diselesaikan.
Keamanan Aplikasi Laravel di Lingkungan Produksi
Setelah aplikasi Laravel berhasil di-deploy, keamanan menjadi perhatian utama. Berbeda dengan lingkungan pengembangan, aplikasi di produksi bisa diakses siapa saja, sehingga rentan terhadap berbagai ancaman. Langkah paling dasar dan penting adalah memastikan APP_DEBUG diatur menjadi false. Jika dibiarkan true, detail error termasuk informasi sensitif tentang aplikasi Anda bisa terlihat oleh pengunjung, yang sangat berbahaya.
Selain itu, pastikan file .env yang berisi kredensial penting tidak bisa diakses publik. Struktur Laravel yang benar sudah menempatkan file ini di luar folder publik, tetapi kesalahan konfigurasi saat deploy ke shared hosting bisa membocorkannya. Selalu periksa bahwa file konfigurasi sensitif tidak dapat diakses langsung melalui browser. Perbarui juga Laravel dan dependency-nya secara berkala untuk mendapatkan perbaikan keamanan terbaru.
Aktifkan HTTPS untuk mengenkripsi data yang dikirim antara pengguna dan server. Sebagian besar hosting modern menyediakan SSL gratis yang bisa diaktifkan dengan mudah. Dengan HTTPS, data sensitif seperti kata sandi dan informasi pribadi pengguna terlindungi dari penyadapan. Kombinasi langkah-langkah keamanan ini membentuk pertahanan dasar yang wajib dimiliki setiap aplikasi Laravel di produksi.
Berlangganan gratis. Artikel & tutorial coding terbaru langsung ke email kamu. Tanpa spam.
Optimasi Performa Setelah Deploy
Agar aplikasi Laravel berjalan cepat di produksi, ada beberapa optimasi yang bisa dilakukan. Laravel menyediakan perintah untuk melakukan cache pada konfigurasi dan rute, yang secara signifikan mempercepat waktu respons aplikasi. Menjalankan cache ini di produksi adalah praktik standar yang sebaiknya tidak dilewatkan setelah proses deploy selesai.
Selain caching bawaan Laravel, perhatikan juga optimasi pada sisi lain seperti mengompres gambar, meminimalkan file CSS dan JavaScript, serta memanfaatkan caching pada level aplikasi untuk data yang sering diakses. Kombinasi optimasi ini membuat aplikasi terasa responsif bahkan pada shared hosting dengan sumber daya terbatas.
Terakhir, pantau performa aplikasi Anda secara berkala. Perhatikan waktu muat halaman dan penggunaan sumber daya. Jika aplikasi mulai terasa lambat meski sudah dioptimasi, itu mungkin menandakan bahwa kebutuhan Anda sudah melampaui kapasitas shared hosting dan saatnya mempertimbangkan upgrade ke VPS. Pemantauan yang rutin membantu Anda menjaga kualitas layanan bagi pengguna.
Memilih Antara Shared Hosting dan VPS untuk Laravel
Setelah memahami cara deploy Laravel ke shared hosting, muncul pertanyaan penting: apakah shared hosting benar-benar pilihan yang tepat untuk aplikasi Anda? Jawabannya bergantung pada kebutuhan proyek. Shared hosting cocok untuk aplikasi Laravel skala kecil seperti website company profile, portofolio, atau aplikasi dengan jumlah pengguna terbatas. Keunggulannya adalah harga terjangkau dan kemudahan pengelolaan lewat cPanel tanpa perlu pengetahuan server yang mendalam.
Namun, shared hosting memiliki keterbatasan. Beberapa fitur Laravel seperti queue worker, task scheduler yang berjalan terus-menerus, atau perintah artisan tertentu sulit atau bahkan tidak bisa dijalankan optimal di shared hosting. Jika aplikasi Anda membutuhkan fitur-fitur ini, atau trafiknya sudah tinggi, VPS menjadi pilihan yang jauh lebih tepat meski memerlukan sedikit pengetahuan konfigurasi server. Pertimbangkan kebutuhan dan pertumbuhan aplikasi Anda saat memilih. Bagi pemula yang baru belajar, memulai dari shared hosting adalah langkah yang wajar dan hemat, dengan opsi upgrade ke VPS ketika aplikasi Anda benar-benar berkembang.
Pertanyaan yang Sering Ditanyakan (FAQ)
Apakah Laravel bisa berjalan lancar di shared hosting?
Bisa, untuk aplikasi skala kecil hingga menengah. Namun untuk fitur seperti queue, scheduler, atau trafik tinggi, VPS memberikan kontrol dan performa yang lebih baik.
Kenapa muncul error 500 setelah deploy?
Penyebab paling umum adalah APP_KEY yang belum diset, permission folder storage yang salah, atau konfigurasi yang belum sesuai. Periksa log error untuk detail lebih lanjut.
Apakah perlu upload folder vendor?
Jika hosting tidak mendukung composer melalui terminal, ya, Anda perlu mengunggah folder vendor bersama project. Jika mendukung, Anda bisa menjalankan composer install langsung di server.
Kesimpulan
Men-deploy Laravel ke shared hosting cPanel memang membutuhkan penyesuaian ekstra, terutama pada struktur folder dan konfigurasi. Namun dengan mengikuti langkah-langkah secara sistematis — menyiapkan file, mengunggah, mengatur database, menyesuaikan file .env, dan menyelesaikan konfigurasi akhir — aplikasi Laravel Anda bisa berjalan online tanpa harus menyewa VPS.
Jika Anda menemui error, jangan panik. Sebagian besar masalah deploy berkaitan dengan permission, APP_KEY, atau konfigurasi database yang mudah diperbaiki. Seiring pengalaman, proses deploy yang tadinya terasa rumit akan menjadi rutinitas yang Anda kuasai dengan baik.
