FrankenPHP — pengantar

FrankenPHP bukan proxy di depan PHP — ia adalah web server Caddy dengan interpreter PHP di dalamnya. Konsekuensinya besar: tidak ada Nginx, tidak ada FPM, tidak ada soket di antara keduanya.

Perbedaan arsitektur

TUMPUKAN KLASIK
  internet → Nginx (TLS, statis) → soket → PHP-FPM (proses per permintaan)
             ↑ dua proses, dua konfigurasi, satu soket di antaranya

FRANKENPHP
  internet → FrankenPHP (TLS, statis, PHP)
             ↑ satu proses, satu konfigurasi

Menjalankan pertama kali

# Docker: cukup pasang proyekmu di /app
docker run -p 80:80 -p 443:443 -p 443:443/udp -v $PWD:/app dunglas/frankenphp

# Biner mandiri, dari folder proyek
frankenphp run
frankenphp php-server --root public/

Caddyfile

{
	frankenphp
}

portal.test {
	root public/
	encode zstd br gzip

	php_server {
		try_files {path} index.php
	}
}

Blok pertama menyalakan modul FrankenPHP; blok kedua mendefinisikan satu situs. Nama domain di sana bukan sekadar label — Caddy memakainya untuk meminta sertifikat TLS secara otomatis. Menuliskan :80 sebagai gantinya mematikan HTTPS, yang tepat kalau ada load balancer yang sudah menanganinya.

Dua mode

Konkurensi berbasis utas

{
	frankenphp {
		num_threads 16          # utas yang selalu ada
		max_threads 48          # batas atas saat lalu lintas melonjak
	}
}

Karena satuannya utas dan bukan proses, jejak memorinya lebih kecil daripada jumlah proses FPM yang setara. Konsekuensinya: PHP harus dikompilasi dalam mode thread-safe (ZTS) — dan setiap ekstensi PHP yang kamu pakai juga harus aman terhadap utas. Ini poin yang perlu diperiksa kalau aplikasimu bergantung pada ekstensi yang tidak umum.

Fitur yang tidak ada di tempat lain