Deploy Aplikasi Laravel di VPS: Panduan Lengkap

by

Laravel adalah framework PHP yang paling populer dan disukai, dikenal karena sintaksnya yang elegan dan fitur yang kuat. Setelah proses pengembangan selesai, langkah krusial berikutnya adalah mendeploy aplikasi Laravel ke lingkungan production yang stabil dan scalable. Meskipun shared hosting mungkin menawarkan kemudahan, aplikasi Laravel modern, terutama yang mengandalkan queue, scheduler, dan cache, membutuhkan Virtual Private Server (VPS).

VPS memberikan kontrol root penuh yang diperlukan untuk menginstal dan mengkonfigurasi software stack yang optimal (Nginx, PHP-FPM, MySQL/MariaDB), menjamin sumber daya terdedikasi, dan memungkinkan implementasi tools deployment otomatis. Proses deployment Laravel di VPS memerlukan langkah-langkah yang berbeda dari deployment PHP statis biasa, melibatkan konfigurasi web server, manajemen dependensi, dan penyiapan proses background.

Artikel ini akan memandu Anda melalui langkah-langkah esensial dan praktik terbaik untuk mendeploy aplikasi Laravel di VPS Linux, mengubah kode yang telah Anda tulis menjadi layanan web yang andal dan siap diakses publik.

Tujuh Langkah Kunci Deployment Laravel di VPS

Deployment aplikasi Laravel di VPS melibatkan serangkaian konfigurasi yang bertujuan untuk keamanan, kinerja, dan konsistensi. Asumsi dasar dalam panduan ini adalah penggunaan sistem operasi Linux berbasis Debian/Ubuntu.

1. Persiapan Server dan Instalasi Environment

Langkah pertama adalah menyiapkan fondasi VPS dengan semua software yang dibutuhkan. Laravel memiliki persyaratan spesifik, terutama pada versi PHP dan ekstensi.

  • Instalasi Stack: Instal web server (sangat direkomendasikan Nginx karena ringan dan efisien untuk web modern), Database (MySQL atau MariaDB), PHP (dengan versi yang didukung Laravel), dan PHP-FPM (FastCGI Process Manager). PHP-FPM adalah kunci kinerja karena menangani eksekusi PHP secara terpisah dari web server.
  • Instalasi Ekstensi PHP Kritis: Pastikan ekstensi PHP seperti mbstring, pdo, xml, dan bcmath terinstal.
  • Instalasi Composer: Composer adalah manajer dependensi utama PHP dan mutlak diperlukan untuk mengelola package Laravel.

2. Pengamanan dan Akses User (Non-Root)

Demi keamanan, aplikasi Laravel tidak boleh dijalankan atau di-deploy menggunakan user root.

  • Buat User Deployment: Buat user baru yang memiliki izin terbatas untuk mengakses direktori aplikasi Anda.
  • Konfigurasi SSH: Gunakan user baru ini untuk semua transfer file dan command line dan, yang terpenting, amankan akses SSH Anda (ubah port, nonaktifkan root login langsung, dan gunakan SSH key).

3. Transfer Kode dan Konfigurasi Git

Metode terbaik untuk mentransfer kode ke VPS adalah menggunakan Git.

  • Kloning Repositori: Kloning repositori Git Anda (GitHub, GitLab, dll.) ke direktori user non-root Anda di VPS (misalnya /var/www/nama-aplikasi).
  • Struktur Direktori: Pastikan direktori root publik web server (Nginx) akan diarahkan ke subdirektori /public di dalam aplikasi Laravel Anda. Ini adalah langkah keamanan penting untuk mencegah akses langsung ke file konfigurasi sensitif.

4. Instalasi Dependensi dan Pengaturan Environment

Setelah kode berada di server, saatnya menyiapkan dependensi dan konfigurasi lingkungan.

Instalasi Dependensi: Navigasi ke direktori aplikasi dan jalankan Composer:

composer install --no-dev --optimize-autoloader

Menggunakan --no-dev menghindari instalasi package pengembangan yang tidak diperlukan di production, dan --optimize-autoloader mempercepat loading kelas.

File Environment (.env): Salin file .env.example ke .env dan edit untuk menyesuaikan database credential, URL aplikasi (APP_URL), dan, yang terpenting, setel APP_ENV=production dan APP_DEBUG=false.

Generate Key Aplikasi: Generate Application Key yang unik:

php artisan key:generate

5. Konfigurasi Web Server (Nginx)

Ini adalah langkah teknis yang menentukan cara Nginx akan menangani permintaan untuk aplikasi Laravel Anda.

Blok Server Nginx: Buat server block baru untuk domain Anda. Pastikan baris root diarahkan ke direktori /public aplikasi Laravel Anda.

server {
    listen 80;
    server_name nama-domain-anda.com;
    root /var/www/nama-aplikasi/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    # Konfigurasi PHP-FPM
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.x-fpm.sock; # Sesuaikan versi PHP
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # Blokir file sensitif
    location ~ /\.env {
        deny all;
    }
}

Restart Nginx: Setelah konfigurasi, aktifkan server block baru dan reload Nginx:

sudo nginx -t && sudo systemctl reload nginx

6. Migrasi Database dan Izin Folder

Migrasi Database: Jalankan migrasi dan seeder (jika ada) untuk menyiapkan struktur database:

php artisan migrate --force

Gunakan --force untuk menghindari prompt konfirmasi di lingkungan production.

Izin Folder: Berikan izin tulis yang tepat kepada web server (biasanya user www-data di Debian/Ubuntu) untuk direktori storage dan bootstrap/cache.

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

7. Menangani Proses Background (Queue dan Scheduler)

Aplikasi Laravel yang efisien sering menggunakan queue (antrian) dan scheduler untuk tugas yang memakan waktu (misalnya, mengirim email atau memproses image).

  • Supervisor untuk Queue: Instal Supervisor dan konfigurasikan untuk memantau proses queue worker Laravel Anda. Supervisor akan secara otomatis me-restart worker jika mereka crash, memastikan pemrosesan queue tidak pernah berhenti.
  • Cron Job untuk Scheduler: Tambahkan satu entri cron job tunggal yang dijalankan setiap menit untuk memicu Laravel Scheduler:
* * * * * cd /var/www/nama-aplikasi && php artisan schedule:run >> /dev/null 2>&1

Kesimpulan

Mendeploy aplikasi Laravel di VPS memerlukan pemahaman mendalam tentang stack LAMP/LEMP, tetapi memberikan imbalan berupa kinerja, keamanan, dan kontrol yang tak tertandingi. Dengan mengkonfigurasi Nginx dengan benar untuk mengarahkan ke folder /public, mengamankan file .env, dan menggunakan tools seperti Composer, PHP-FPM, dan Supervisor, Anda membangun fondasi hosting yang optimal. Proses deployment yang terstruktur ini memastikan aplikasi Laravel Anda tidak hanya berjalan, tetapi berkinerja tinggi, stabil, dan aman di lingkungan production.

Kata Penutup

Deployment yang sukses adalah hasil dari persiapan yang matang dan pemahaman mendalam tentang ekosistem Laravel di lingkungan Linux. Jangan pernah berkompromi pada langkah-langkah keamanan seperti file permission dan konfigurasi web server. Dengan menguasai VPS, Anda memegang kendali penuh untuk mengoptimalkan setiap aspek aplikasi Anda, memastikan user mendapatkan pengalaman yang cepat dan andal. Kini, server Anda siap menghadapi beban kerja yang sebenarnya.

Leave a Comment