Blog teknologi & gadget Sejak 2017 · RSS
Tech

Deploy Framework Laravel di Cloud VPS: Panduan Setup Nginx, PHP-FPM, dan Composer untuk Pemula

Panduan langkah demi langkah deploy Laravel di Cloud VPS untuk pemula: setup Nginx, PHP-FPM, Composer, database, sampai aplikasi jalan di domain.

Deploy Framework Laravel di Cloud VPS: Panduan Setup Nginx, PHP-FPM, dan Composer untuk Pemula
Daftar Isi 7
  1. Panduan Setup Nginx, PHP-FPM, dan Composer untuk Deploy Framework Laravel di Cloud VPS
  2. 1. Menyiapkan Cloud VPS dan Mengakses Server
  3. 2. Memasang dan Mengonfigurasi Nginx
  4. 3. Memasang PHP-FPM dan Menyesuaikan Versi PHP
  5. 4. Menginstal Composer dan Menyiapkan Aplikasi Laravel
  6. 5. Menghubungkan Database dan Melakukan Pengujian
  7. Kesimpulan

Menjalankan aplikasi Laravel di server sendiri bisa menjadi langkah awal untuk memahami proses deployment secara langsung. Hal ini penting diketahui, terutama jika Anda ingin memanfaatkan VPS murah untuk mengembangkan proyek web.

Meski terdengar teknis, proses deploy Laravel ke Cloud VPS sebenarnya dapat dilakukan secara bertahap. Laravel membutuhkan lingkungan server yang sesuai agar dapat berjalan dengan baik. Beberapa komponen yang perlu disiapkan antara lain Nginx sebagai web server, PHP-FPM untuk memproses script PHP, serta Composer untuk mengelola dependency aplikasi.

Panduan Setup Nginx, PHP-FPM, dan Composer untuk Deploy Framework Laravel di Cloud VPS

Dengan konfigurasi yang tepat, aplikasi bisa berjalan lebih stabil dan siap diakses melalui domain. Berikut beberapa tahapan yang dapat Anda ikuti untuk melakukan deployment Laravel ke Cloud VPS.

1. Menyiapkan Cloud VPS dan Mengakses Server

Untuk proyek Laravel berskala kecil, pengembangan website, atau aplikasi yang baru dirilis, Cloud VPS Lite dapat menjadi pilihan awal untuk membangun lingkungan server tanpa harus langsung menggunakan resource yang besar.

Setelah VPS aktif, pilih sistem operasi seperti Ubuntu yang memiliki dukungan paket dan dokumentasi cukup lengkap. Kemudian, hubungkan server melalui SSH menggunakan alamat IP dan kredensial yang tersedia.

ssh [email protected]

Setelah berhasil masuk, jalankan pembaruan sistem agar paket yang terpasang menggunakan versi terbaru dari repositori yang tersedia.

sudo apt update && sudo apt upgrade -y

2. Memasang dan Mengonfigurasi Nginx

Nginx bertugas menerima permintaan dari browser dan meneruskannya ke aplikasi. Web server ini dikenal efisien dalam menangani banyak koneksi, sehingga cocok digunakan untuk berbagai kebutuhan website berbasis Laravel. Pada Ubuntu, Anda dapat memasang Nginx melalui package manager dengan perintah berikut:

sudo apt update
sudo apt install nginx

Setelah instalasi selesai, aktifkan layanan agar berjalan otomatis ketika server dinyalakan kembali.

sudo systemctl enable --now nginx

Berikutnya, siapkan konfigurasi virtual host atau server block untuk domain yang digunakan. Pastikan direktori utama website mengarah ke folder public milik Laravel, bukan ke folder root proyek.

server {
    listen 80;
    server_name contoh.com www.contoh.com;
    root /var/www/laravel/public;

    index index.php index.html;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Simpan konfigurasi tersebut di /etc/nginx/sites-available/laravel, aktifkan dengan symlink, lalu uji konfigurasi sebelum memuat ulang Nginx.

sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

3. Memasang PHP-FPM dan Menyesuaikan Versi PHP

Laravel membutuhkan PHP beserta ekstensi tertentu agar seluruh fitur aplikasi dapat berfungsi. Karena itu, periksa terlebih dahulu persyaratan versi PHP dari Laravel dan dependency proyek sebelum melakukan instalasi.

PHP-FPM berfungsi sebagai penghubung antara Nginx dan interpreter PHP. Anda perlu memasang PHP-FPM beserta ekstensi yang diperlukan, misalnya ekstensi untuk database, pengolahan string, dan XML, sesuai kebutuhan aplikasi.

sudo apt install php8.3-fpm php8.3-mysql php8.3-xml php8.3-mbstring php8.3-curl php8.3-zip

Sesuaikan nomor versi PHP dengan kebutuhan proyek. Jika server memakai versi lain, ganti php8.3 pada perintah di atas.

Setelah instalasi, pastikan layanan PHP-FPM aktif. Kemudian, sesuaikan konfigurasi Nginx agar permintaan file PHP diteruskan ke socket atau port PHP-FPM yang benar. Periksa juga konfigurasi fastcgi_pass agar sesuai dengan lingkungan server.

sudo systemctl enable --now php8.3-fpm
php -v

4. Menginstal Composer dan Menyiapkan Aplikasi Laravel

Composer merupakan pengelola dependency PHP yang digunakan Laravel untuk memasang library yang dibutuhkan aplikasi. Pasang Composer secara global agar bisa dipanggil dari direktori mana pun.

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Setelah Composer tersedia, ambil kode proyek melalui Git atau unggah berkas aplikasi ke server. Masuk ke direktori proyek, kemudian jalankan perintah berikut:

cd /var/www/laravel
composer install --no-dev --optimize-autoloader

Perintah tersebut memasang dependency produksi berdasarkan file konfigurasi proyek. Selanjutnya, salin .env.example menjadi .env jika file konfigurasi belum tersedia, lalu isi pengaturan database, alamat aplikasi, dan variabel lingkungan lainnya.

cp .env.example .env
nano .env

Buat application key menggunakan Artisan:

php artisan key:generate

Pastikan file .env tidak dapat diakses secara publik. Atur pula kepemilikan dan permission folder storage serta bootstrap/cache agar dapat ditulisi oleh proses aplikasi tanpa memberikan akses berlebihan.

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

5. Menghubungkan Database dan Melakukan Pengujian

Buat database dan akun khusus dengan hak akses yang diperlukan, kemudian masukkan informasi koneksinya ke file .env. Sebelum menjalankan migration, pastikan konfigurasi database benar dan cadangan data tersedia jika menggunakan database yang sudah berisi informasi penting. Untuk lingkungan produksi, jalankan:

php artisan migrate --force
php artisan config:cache
php artisan route:cache

Sesuaikan perintah cache dengan kondisi proyek karena tidak semua aplikasi cocok menggunakan cache route. Setelah itu, periksa konfigurasi Nginx, status PHP-FPM, log aplikasi, dan akses domain melalui browser.

sudo nginx -t
sudo systemctl status php8.3-fpm
tail -f storage/logs/laravel.log

Kesimpulan

Deploy Laravel ke Cloud VPS tidak harus terasa rumit jika dilakukan dengan urutan yang jelas, mulai dari menyiapkan server, memasang Nginx dan PHP-FPM, mengelola dependency melalui Composer, hingga menghubungkan database. Untuk pemula, memilih kapasitas server yang sesuai juga membantu proses pengembangan berjalan lebih efisien.

Kalau masih ragu menentukan spesifikasi, lihat juga pembahasan perbedaan resource allocation di hosting agar kapasitas server tidak kekurangan atau justru berlebihan.

Anda dapat mempertimbangkan Cloud VPS Lite sebagai titik awal untuk menjalankan proyek Laravel dan meningkatkan resource ketika kebutuhan aplikasi bertambah. Agar pengelolaan server lebih nyaman, bangun aplikasi dengan konfigurasi yang tepat dan dukungan infrastruktur yang sesuai dengan kebutuhan, menggunakan layanan terpercaya dan berkualitas dari DomaiNesia.