Tutorial Deploy Laravel ke Vercel Gratis 2026: Panduan Lengkap & Cepat

oleh

Menemukan layanan hosting yang handal namun tetap hemat biaya adalah tantangan utama bagi developer di tahun 2026. Banyak developer mencari tutorial deploy laravel ke vercel gratis 2026 karena Vercel menawarkan infrastruktur serverless yang sangat cepat, skalabel, dan memiliki free tier yang sangat murah hati bagi para hobiis maupun startup tahap awal.

Laravel, sebagai framework PHP paling populer, biasanya membutuhkan server tradisional (VPS) atau shared hosting. Namun, dengan kemajuan teknologi runtime PHP di ekosistem serverless, kini menjalankan Laravel di Vercel bukan lagi sekadar impian, melainkan standar baru untuk efisiensi. Artikel ini akan memandu Anda langkah demi langkah secara komprehensif.

Mengapa Memilih Vercel untuk Laravel di 2026?

Vercel dikenal luas sebagai rumah bagi Next.js, namun fleksibilitasnya melalui Community Runtimes memungkinkan eksekusi bahasa pemrograman lain seperti PHP. Pada tahun 2026, ekosistem ini semakin matang dengan dukungan PHP 8.3+ dan integrasi CI/CD yang mulus.

Beberapa keunggulan utama menggunakan Vercel untuk Laravel meliputi:

  • Global Edge Network: Konten Anda disajikan dari lokasi terdekat dengan pengguna, mengurangi latensi secara signifikan.
  • Skalabilitas Otomatis: Anda tidak perlu khawatir tentang lonjakan trafik; Vercel menangani penskalaan secara otomatis tanpa intervensi manual.
  • Gratis Selamanya: Selama Anda berada dalam batas penggunaan personal, Anda tidak perlu mengeluarkan uang sepeser pun untuk hosting.
  • Preview Deployments: Setiap pull request di GitHub akan mendapatkan URL unik untuk testing sebelum digabung ke branch utama.

Persiapan Awal Sebelum Deployment

Sebelum memulai tutorial deploy laravel ke vercel gratis 2026 ini, pastikan Anda telah menyiapkan alat-alat berikut di perangkat lokal Anda:

  1. PHP 8.2 atau 8.3: Versi terbaru Laravel membutuhkan versi PHP yang modern.
  2. Composer: Untuk manajemen dependensi Laravel.
  3. Node.js & NPM/Bun: Diperlukan untuk kompilasi aset frontend menggunakan Vite.
  4. Akun GitHub/GitLab: Vercel akan menarik kode Anda dari repositori Git.
  5. Vercel CLI: Opsional, namun sangat disarankan untuk testing lokal (npm i -g vercel).

Catatan Penting: Karena Vercel adalah lingkungan serverless, sistem file bersifat read-only. Anda tidak bisa menyimpan file upload secara lokal di folder storage/app/public. Gunakan layanan eksternal seperti AWS S3 atau Cloudinary.

Konfigurasi Proyek Laravel (Struktur Folder)

Langkah pertama dalam tutorial ini adalah menyesuaikan struktur proyek Laravel agar kompatibel dengan cara kerja Vercel. Vercel mengharapkan entry point di folder tertentu.

Pertama, buatlah folder bernama api di root direktori proyek Anda. Di dalam folder api tersebut, buat file bernama index.php. File ini akan bertindak sebagai jembatan antara request Vercel dan public/index.php milik Laravel.


// Isi dari api/index.php
require __DIR__ . '/../public/index.php';

Selanjutnya, pastikan folder bootstrap/cache dan storage/framework/views memiliki izin yang tepat, meskipun di Vercel kita akan mengarahkan cache ini ke direktori /tmp karena keterbatasan sistem file read-only.

Membuat File vercel.json yang Optimal

Ini adalah bagian terpenting dari tutorial deploy laravel ke vercel gratis 2026. File vercel.json memberitahu Vercel bagaimana cara memproses kode PHP Anda. Buat file ini di root direktori:


{
  "version": 2,
  "functions": {
    "api/index.php": {
      "runtime": "[email protected]"
    }
  },
  "routes": [
    {
      "src": "/build/(.*)",
      "dest": "/public/build/$1"
    },
    {
      "src": "/(.*)",
      "dest": "/api/index.php"
    }
  ],
  "env": {
    "APP_CONFIG_CACHE": "/tmp/config.php",
    "APP_ROUTES_CACHE": "/tmp/routes.php",
    "VIEW_COMPILED_PATH": "/tmp",
    "CACHE_DRIVER": "array",
    "LOG_CHANNEL": "stderr",
    "SESSION_DRIVER": "cookie"
  }
}

Penjelasan Konfigurasi:

  • runtime: Kita menggunakan community runtime vercel-php. Pastikan menggunakan versi terbaru yang mendukung PHP 8.x.
  • routes: Mengarahkan semua permintaan ke file bridge yang kita buat di folder api, kecuali untuk aset statis di folder build.
  • env: Kita memindahkan lokasi cache ke folder /tmp karena hanya folder itu yang bisa ditulisi (writeable) di lingkungan Vercel Lambda.

Strategi Database Serverless (PlanetScale/Supabase)

Laravel membutuhkan database untuk berfungsi secara penuh. Karena Vercel tidak menyediakan database MySQL/PostgreSQL bawaan, Anda harus menggunakan penyedia database eksternal yang mendukung koneksi serverless.

Di tahun 2026, pilihan terbaik adalah:

  • Supabase: Menawarkan PostgreSQL gratis dengan integrasi yang sangat mudah.
  • Neon.tech: Database PostgreSQL serverless yang bisa “tidur” saat tidak digunakan untuk menghemat biaya.
  • PlanetScale: Jika Anda lebih menyukai MySQL (sangat cocok untuk Laravel).

Setelah membuat database, ambil Connection String dan simpan untuk dimasukkan ke Environment Variables di Vercel nanti.

Menjalankan Migrasi Database

Karena Anda tidak memiliki akses SSH ke Vercel, cara termudah untuk menjalankan php artisan migrate adalah dengan membuat temporary route di routes/web.php:


Route::get('/run-migration', function () {
    Artisan::call('migrate', ['--force' => true]);
    return "Migration finished!";
});

Pastikan menghapus route ini setelah migrasi selesai demi keamanan.

Langkah-Langkah Deploy ke Dashboard Vercel

Setelah semua konfigurasi lokal selesai, saatnya mempublikasikan proyek Anda:

  1. Push kode Anda ke repositori GitHub.
  2. Buka Vercel Dashboard dan login dengan akun GitHub Anda.
  3. Klik “Add New” lalu pilih “Project”.
  4. Impor repositori Laravel yang baru saja Anda push.
  5. Pada bagian Build & Development Settings, biarkan default atau sesuaikan jika Anda menggunakan Vite.
  6. Buka bagian Environment Variables dan masukkan key dari file .env Anda (seperti APP_KEY, DB_CONNECTION, DB_HOST, dll).
  7. Klik Deploy.

Vercel akan mulai membangun proyek Anda. Jika berhasil, Anda akan melihat kembang api di layar dan URL aplikasi Laravel Anda akan aktif seketika.

Troubleshooting Error Umum (500 Internal Server Error)

Banyak pengguna mengalami kendala saat pertama kali mencoba tutorial deploy laravel ke vercel gratis 2026. Berikut adalah solusi untuk masalah yang paling sering muncul:

1. Masalah APP_KEY

Pastikan Anda telah menambahkan APP_KEY di Environment Variables Vercel. Tanpa ini, Laravel akan melempar error demi keamanan enkripsi data.

2. Folder Storage Tidak Bisa Ditulisi

Jika Anda melihat error terkait Permission Denied di folder storage, pastikan Anda sudah mengikuti langkah di bagian vercel.json untuk memindahkan path cache ke /tmp.

3. Vite Manifest Not Found

Jika CSS atau JS tidak muncul, pastikan Anda menjalankan npm run build sebelum push, atau atur Vercel agar menjalankan build command tersebut saat deployment.

Optimasi Performa Laravel di Lingkungan Serverless

Agar aplikasi Laravel Anda berjalan secepat kilat di Vercel, pertimbangkan tips berikut:

  • Optimize Autoloader: Gunakan composer install --optimize-autoloader --no-dev saat proses build.
  • Route & Config Caching: Walaupun di serverless sedikit berbeda, pastikan konfigurasi Anda tetap ringkas.
  • Gunakan CDN untuk Gambar: Jangan membebani serverless function dengan memproses gambar besar. Gunakan layanan seperti ImageKit atau Cloudinary.
  • Minimalkan Package: Hapus package yang tidak perlu di composer.json untuk mengurangi cold start time pada Lambda function.

Kesimpulan dan Langkah Selanjutnya

Menerapkan tutorial deploy laravel ke vercel gratis 2026 adalah langkah cerdas bagi developer modern yang mengutamakan kecepatan dan efisiensi biaya. Dengan memanfaatkan arsitektur serverless, Anda mendapatkan performa kelas dunia tanpa harus pusing memikirkan manajemen server.

Kini aplikasi Laravel Anda sudah online dan siap diakses oleh dunia. Langkah selanjutnya adalah menyiapkan sistem monitoring error seperti Sentry dan memastikan backup database otomatis berjalan dengan baik.

Apakah Anda siap membangun proyek hebat berikutnya dengan Laravel dan Vercel? Jangan ragu untuk bereksperimen dengan fitur-fitur baru Laravel 11 atau 12 yang semakin ringan dan cocok untuk lingkungan cloud.

Tinggalkan komentar