Belajar Symfony - Worker Mode: FrankenPHP & RoadRunner

#Pendahuluan

Selama 21 episode, aplikasi berjalan dengan model eksekusi klasik PHP: proses di-spawn per request (FPM). Episode 22 memperkenalkan model baru yang sedang naik daun di 2026: worker mode — aplikasi yang di-load sekali dan hidup terus, melayani banyak request.

Mengapa ini penting? Karena biaya terbesar request bukan kode-nya, melainkan bootstrap — inisialisasi container, load autoloader, build metadata. Worker mode membayar biaya itu sekali saja. Hasilnya: peningkatan performa yang signifikan tanpa menambah server, dan itu alasan utama ekosistem PHP bergerak ke arah ini.

#Memahami Model Eksekusi

#PHP-FPM: Born-per-Request

Setiap request mem-bootstrap seluruh aplikasi: container, autoload, metadata. Konsisten dan aman (state tidak bocor antar request), tapi boros untuk beban tinggi.

#Worker Mode: Long-Lived

Aplikasi di-load sekali; request berikutnya tinggal diproses. Bootstrap tidak berulang — inilah sumber kecepatannya.

#Symfony Runtime

Symfony Runtime adalah abstraksi yang membuat aplikasi bisa dijalankan di berbagai model eksekusi tanpa mengubah kode:

composer require symfony/runtime

Dengan runtime terpasang, public/index.php meminta runtime memilih runtime yang aktif. Kode aplikasi tidak berubah — hanya cara menjalankannya yang berbeda. Inilah yang membuat migrasi ke worker mode semulus mungkin.

#FrankenPHP

FrankenPHP adalah app server PHP yang menanamkan PHP langsung di Caddy (Go). Menariknya: ia memakai model worker dengan cara yang automatic:

composer require frankenphp/symfony-runtime

Kode (dengan PHP 8.4+ dan APP_RUNTIME=Runtime\\FrankenPHPRuntime) mengenali variabel environment FrankenPHP dan otomatis masuk worker mode:

APP_RUNTIME=Runtime\FrankenPHPRuntime
FRANKENPHP_WORKER=1

Run via image resmi:

docker run -v .:/app -p 8080:80 dunglas/frankenphp:8.4

Keunggulan FrankenPHP:

Untuk memaksimalkan cache opcode dalam mode worker, hindari opcache.validate_timestamps di dev — di production, set 0 (seperti episode 14).

#RoadRunner

RoadRunner (ditulis Go oleh Spiral) adalah pendekatan berbeda: server Go memakai PHP sebagai worker dalam sub-proses:

composer require spiral/roadrunner-cli
composer require spiral/roadrunner-symfony
vendor/bin/rr get

Konfigurasi .rr.yaml:

server:
    command: "php worker.php"
 
http:
    address: ":8080"
    pool:
        num_workers: 8

worker.php adalah entri point standar:

use Symfony\Component\Runtime\SymfonyRuntime;
use Symfony\Component\HttpKernel\KernelInterface;
 
require_once dirname(__DIR__) . '/vendor/autoload_runtime.php';
 
return function (array $context): KernelInterface {
    $kernel = new App\Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
 
    return $kernel;
};

Lalu:

./rr serve

Keunggulan RoadRunner:

#Kapan Memilih Mana

#Worker Mode dan Messenger

Worker mode bukan hanya untuk HTTP — ia berpasangan sempurna dengan Messenger (episode 10): worker yang sama bisa melayani HTTP dan mengkonsumsi antrian. Dengan RoadRunner misalnya, eksekutor HTTP dan jobs diatur dalam satu server:

http:
    address: ":8080"
 
jobs:
    consume:
        - "app.queue"

Ini menyederhanakan operasional: satu proses, satu health check, satu unit scaling.

#Common Pitfalls

• State bocor antar request — di worker mode, variabel statis & global tidak reset antar request. Symfony aman (container stateless), tapi kode custom dengan global/static harus disterilkan.
• File upload & streaming — pastikan handler reset() atau state per-request dibersihkan di akhir request (Symfony Runtime menangani ini).
• Perilaku dev vs prod — opcache + cache container berlaku lama di worker; selalu cache:clear/restart worker saat deploy.

#Penutup

Pada episode 22 ini, kalian telah memahami dan menjalankan worker mode.

Inti yang harus dibawa pulang:

• PHP-FPM spawns per request; worker mode melayani banyak request dari satu proses.
• Symfony Runtime mengabstraksi model eksekusi tanpa mengubah kode.
• FrankenPHP (Caddy + PHP): worker otomatis, HTTPS bawaan, setup 1 menit.
• RoadRunner (Go + PHP): kontrol pool manual, GRPC/jobs/KV terintegrasi.
• Hati-hati state global & lifecycle opcache di worker mode.

Di episode 23 selanjutnya kita mempackaging semuanya: Docker & Deployment CI/CD — Dockerfile multi-stage, compose untuk dev/prod, migrasi & cache warmup saat deploy, dan pipeline GitHub Actions. Sampai jumpa di episode 23!