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
pcntldanposixyang 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=frankenphpPerintah 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/frankenphpBedah 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 userwww-datamaupun 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.

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=3600Selanjutnya, 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=4dan--max-requests=500pada 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=500bertindak 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.

⚠️ Troubleshooting & Skenario Error Handling di Lapangan
Error Spesifik: Perubahan kode baru setelah
git pullpada pipeline CI/CD tidak muncul di browser, atau muncul pesanUnable to bind to address 127.0.0.1:8000: address already in usesaat 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:reloadagar worker memuat ulang file aplikasi tanpa memutus koneksi pengguna yang sedang aktif (zero-downtime reload). Jika port 8000 terkunci akibat proses yatim (orphan process), jalankanphp artisan octane:stopsebelum 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
0Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.
Belum Ada Komentar
Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!