Laravel Diterbitkan: • Diperbarui: • 7 menit baca • 38 views

Laravel Octane FrankenPHP: Setup Production & Tuning VPS

Juan Mths
Juan Mths
Chief Technology Officer & Administrator • Skor SEO: 100/100
Ilustrasi Laravel Octane FrankenPHP: Setup Production & Tuning VPS
Laravel Featured Article Laravel Octane FrankenPHP: Setup Production & Tuning VPS

Untuk menjalankan Laravel Octane dengan FrankenPHP di server VPS produksi, Anda perlu menginstal paket laravel/octane, mengunduh binary FrankenPHP yang telah dikompilasi dengan ekstensi PHP modern, serta mendaftarkan worker Octane ke dalam Supervisor. Arsitektur ini memuat seluruh kerangka kerja Laravel ke dalam memori RAM satu kali saat startup, sehingga memangkas latensi eksekusi API hingga di bawah 15 milidetik tanpa harus melakukan booting ulang framework pada setiap permintaan masuk.

Setelah pada seri sebelumnya kita berhasil menerapkan Server-Side Rendering (SSR) dan Redis Caching pada Laravel Inertia Vue 3, hambatan berikutnya sering kali muncul pada lapisan eksekusi PHP itu sendiri. Pada arsitektur PHP-FPM konvensional, setiap kali pengguna membuka halaman atau memanggil endpoint API, server harus membaca ulang ratusan file konfigurasi, menginisialisasi Service Providers, dan menghancurkannya kembali begitu respons terkirim.

Prasyarat Teknis & Perbandingan Arsitektur Server

Sebelum memasang Octane di lingkungan produksi, pastikan server Cloud VPS Anda telah memenuhi spesifikasi berikut agar worker berbasis memori berjalan stabil tanpa kehabisan RAM:

  • Sistem Operasi & Infrastruktur: Ubuntu 22.04 LTS atau 24.04 LTS (arsitektur x86_64 atau ARM64) dengan minimal 2 vCPU dan 2 GB RAM.

  • Versi Framework & Runtime: Laravel 11.x dan PHP 8.2 atau 8.3 (CLI) beserta ekstensi pcntl dan posix yang aktif.

  • Manajemen Proses & Reverse Proxy: Supervisor untuk menjaga siklus hidup daemon serta Nginx sebagai gerbang terminasi SSL/TLS.

Dalam implementasi Enterprise Architecture dan aplikasi SaaS multi-tenant yang saya kelola, pemilihan application server berdampak langsung pada biaya infrastruktur bulanan. Tabel di bawah ini membandingkan karakteristik teknis antara PHP-FPM klasik, Swoole, dan FrankenPHP:

Parameter Teknis

Nginx + PHP-FPM

Octane + Swoole

Octane + FrankenPHP

Siklus Boot Framework

Ulang setiap 1 request

Sekali saat worker start

Sekali saat worker start

Kompleksitas Instalasi

Standar bawaan distro

Tinggi (Kompilasi PECL C++)

Sangat Mudah (Single Binary)

Dukungan Protokol

HTTP/1.1 & HTTP/2 via Nginx

HTTP/1.1, HTTP/2, WebSocket

Native HTTP/2, HTTP/3 & Early Hints

Rata-Rata Latensi API

75ms – 140ms

8ms – 18ms

7ms – 15ms

Langkah 1: Instalasi Laravel Octane & Binary FrankenPHP

Masuk ke direktori root proyek Laravel Anda di server VPS (misalnya /var/www/sarjanait), lalu pasang paket resmi Laravel Octane melalui Composer dan jalankan perintah instalasi interaktif:

composer require laravel/octane
php artisan octane:install --server=frankenphp

Perintah di atas otomatis menerbitkan file konfigurasi config/octane.php sekaligus mengunduh binary frankenphp ke dalam folder root proyek Anda. Jika Anda menjalankan proses build di dalam pipeline otomatis tanpa interaksi terminal, unduh binary resmi secara eksplisit dan berikan izin eksekusi:

curl -L https://github.com/dunglas/frankenphp/releases/latest/download/frankenphp-linux-x86_64 -o frankenphp
chmod +x frankenphp
sudo mv frankenphp /usr/local/bin/frankenphp

Bedah Teknis Langkah Instalasi:

  • --server=frankenphp: Mengonfigurasi Octane untuk berkomunikasi langsung dengan engine server berbasis bahasa Go (Caddy) yang tertanam bersama PHP ZTS (Zend Thread Safety).

  • Pemindahan ke /usr/local/bin/: Memastikan binary FrankenPHP dapat diakses secara global oleh user www-data maupun Supervisor tanpa terkendala jalur relatif saat proses deployment berlangsung.

Langkah 2: Konfigurasi & Hardening Kode untuk Aplikasi Stateful

Karena Octane mempertahankan instance aplikasi di dalam memori RAM selama ribuan siklus permintaan, cara kita menulis kode tidak lagi bersifat stateless sepenuhnya. Periksa file config/octane.php dan pastikan daftar pembersih state (listeners) tetap aktif untuk mencegah kebocoran data sesi antar-pengguna:

<?php

return [
    'server' => env('OCTANE_SERVER', 'frankenphp'),
    'https' => env('OCTANE_HTTPS', false),

    'listeners' => [
        WorkerStarting::class => [
            EnsureUploadedFilesAreValid::class,
            EnsureUploadedFilesCanBeMoved::class,
        ],
        RequestReceived::class => [
            ...Octane::prepareApplicationForNextOperation(),
            ...Octane::prepareApplicationForNextRequest(),
        ],
        RequestTerminated::class => [
            // Bersihkan state kustom setelah respons dikirim
        ],
    ],

    'max_execution_time' => 30,
];

Kesalahan paling fatal yang sering saya temui saat mengaudit proyek Laravel sebelum migrasi ke Octane adalah menyuntikkan objek Request atau Auth ke dalam konstruktor Singleton Service. Berikut adalah pola kode aman untuk produksi:

<?php

namespace App\Services;

use Illuminate\Container\Container;
use Illuminate\Http\Request;

class TenantResolverService
{
    // JANGAN simpan $this->request di __construct() pada Singleton!
    public function getCurrentTenantDomain(): string
    {
        /** @var Request $request */
        $request = Container::getInstance()->make('request');

        return $request->getHost();
    }
}

Dengan mengambil instance request langsung melalui Service Container di dalam metode (bukan menyimpannya sebagai properti kelas pada saat register()), aplikasi selalu membaca header HTTP milik pengguna yang sedang aktif saat itu.

Hasil benchmark throughput dan latensi rendah Laravel Octane FrankenPHP menggunakan wrk di server VPS

Langkah 3: Konfigurasi Supervisor & Reverse Proxy Nginx

Di server produksi, kita menjalankan FrankenPHP di port internal 8000 yang diawasi oleh Supervisor, sementara Nginx berdiri di depan pada port 80/443 untuk menangani sertifikat SSL Let's Encrypt serta menyajikan aset statis (CSS, JS, gambar) secara langsung.

Buat file konfigurasi worker Supervisor di /etc/supervisor/conf.d/octane-frankenphp.conf:

[program:octane-frankenphp]
process_name=%(program_name)s
command=php /var/www/sarjanait/artisan octane:start --server=frankenphp --host=127.0.0.1 --port=8000 --workers=4 --max-requests=500
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=www-data
redirect_stderr=true
stdout_logfile=/var/www/sarjanait/storage/logs/octane.log
stopwaitsecs=3600

Selanjutnya, arahkan virtual host Nginx Anda di /etc/nginx/sites-available/sarjanait.conf untuk meneruskan trafik dinamis ke worker FrankenPHP menggunakan protokol HTTP/1.1 keep-alive:

upstream octane_backend {
    server 127.0.0.1:8000;
    keepalive 32;
}

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

    index index.php;
    charset utf-8;

    location /index.php {
        try_files /not_exists @octane;
    }

    location / {
        try_files $uri $uri/ @octane;
    }

    location @octane {
        set $suffix "";
        if ($uri = /index.php) {
            set $suffix ?$query_string;
        }

        proxy_http_version 1.1;
        proxy_set_header Host $http_host;
        proxy_set_header Scheme $scheme;
        proxy_set_header SERVER_PORT $server_port;
        proxy_set_header REMOTE_ADDR $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_pass http://octane_backend$suffix;
    }
}

💡 Tips Praktis & Optimasi Performa dari Pengalaman Saya

Perhatikan parameter --workers=4 dan --max-requests=500 pada konfigurasi Supervisor di atas. Aturan praktis yang paling stabil di server VPS produksi adalah menyetel jumlah worker sebanyak 2x jumlah inti CPU (vCPU) apabila aplikasi Anda banyak melakukan query database I/O.

Sementara itu, parameter --max-requests=500 bertindak sebagai katup pengaman otomatis: setiap worker akan me-restart dirinya secara halus setelah melayani 500 permintaan guna membebaskan sisa fragmen memori yang tertahan oleh library pihak ketiga.

Ilustrasi Laravel Octane FrankenPHP: Setup Production & Tuning VPS

⚠️ Troubleshooting & Skenario Error Handling di Lapangan

Error Spesifik: Perubahan kode baru setelah git pull pada pipeline CI/CD tidak muncul di browser, atau muncul pesan Unable to bind to address 127.0.0.1:8000: address already in use saat restart manual.

Akar Masalah & Solusi: Karena Octane menyimpan kode PHP yang sudah dikompilasi di dalam memori, deployment kode baru wajib disertai perintah php artisan octane:reload agar worker memuat ulang file aplikasi tanpa memutus koneksi pengguna yang sedang aktif (zero-downtime reload). Jika port 8000 terkunci akibat proses yatim (orphan process), jalankan php artisan octane:stop sebelum memulai ulang service Supervisor.

FAQ Teknis Laravel Octane & FrankenPHP

1. Apakah fitur upload file dan session Laravel tetap aman di Octane?

Aman sepenuhnya, asalkan Anda menggunakan driver session eksternal seperti redis atau database dan menghindari penggunaan driver array. Laravel Octane secara otomatis membersihkan instance session dan objek file unggahan pada setiap siklus event RequestReceived.

2. Mengapa tetap memakai Nginx di depan FrankenPHP padahal FrankenPHP sudah punya web server Caddy?

Dalam lingkungan VPS multi-aplikasi atau ketika Anda sudah memiliki konfigurasi firewall, rate limiting, dan manajemen SSL terpusat di Nginx, menempatkan Nginx sebagai reverse proxy memudahkan isolasi trafik dan penyajian aset statis tanpa mengubah arsitektur jaringan yang sudah berjalan.

3. Bagaimana cara mendeteksi kebocoran memori (Memory Leak) pada aplikasi saya saat memakai Octane?

Jalankan perintah php artisan octane:start --watch di lingkungan staging lokal, lalu lakukan pengujian beban dengan 1.000 request beruntun sambil memantau kolom RES di htop. Jika penggunaan memori terus naik tanpa pernah turun setelah siklus --max-requests tercapai, periksa penggunaan properti static pada kelas PHP atau event listener yang terus menumpuk.

4. Apakah semua paket Composer pihak ketiga kompatibel dengan Laravel Octane?

Sebagian besar paket modern Laravel sudah mendukung Octane. Namun, paket lama yang menyimpan koneksi database atau state pengguna di dalam variabel statis global perlu didaftarkan ke dalam array flush di file config/octane.php agar di-reset setiap kali permintaan selesai diproses.

Diskusi & Komentar

0

Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.

Tulis Komentar
* Tautan dalam komentar otomatis diamankan dengan atribut rel="nofollow ugc". Maks 2.000 karakter
Moderasi aktif: komentar akan ditinjau sebelum terbit.

Belum Ada Komentar

Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!