FrankenPHP di produksi

FrankenPHP dengan setelan bawaan sudah baik. Perbedaan antara "baik" dan "cepat" ada pada beberapa setelan yang seluruhnya bisa kamu pasang dalam satu sore.

Pilihan basis image

Utas dan worker

{
	frankenphp {
		num_threads 16
		max_threads 48

		worker {
			file /app/public/worker.php
			num 12
		}
	}
}

1. Mulai dari num_threads = 2–4× jumlah inti kalau bebannya banyak menunggu I/O.
2. Pastikan num_threads × memory_limit lebih kecil daripada memori yang tersedia.
3. Pakai max_threads supaya lonjakan tidak langsung berubah jadi antrean panjang.
4. Jangan menebak — jalankan uji beban yang menyerupai lalu lintas nyata.

Runtime Go

GODEBUG=cgocheck=0        # sudah default di image resmi
GOMEMLIMIT=1750MiB        # untuk kontainer berjatah 2 GiB

Mengurangi operasi filesystem

# Sebelum: php_server mencoba beberapa kemungkinan berkas tiap permintaan
php_server

# Sesudah: satu kemungkinan saja, dan root dinyatakan eksplisit
php_server {
	try_files {path} index.php
	root /app/public
	resolve_root_symlink false
}

Menyebutkan root secara eksplisit memungkinkan nilainya di-cache. Sebaliknya, memakai placeholder Caddy di dalam root atau env mematikan caching itu dan membawa biaya yang nyata — hindari di jalur yang sering dilalui.

# Paling hemat: pisahkan aset dari PHP berdasarkan path,
# supaya tidak ada pemeriksaan filesystem sama sekali untuk permintaan aplikasi
route {
	@aset path /build/* /images/*
	file_server @aset {
		root /app/public
	}

	rewrite index.php
	php {
		root /app/public
	}
}

Penyetelan PHP yang tetap berlaku

opcache.enable=1
opcache.enable_cli=1
opcache.memory_consumption=256
opcache.max_accelerated_files=20000
opcache.validate_timestamps=0

realpath_cache_size=4096K
realpath_cache_ttl=600

memory_limit=256M

composer install --no-dev --optimize-autoloader
php artisan optimize

Kolam utas untuk endpoint lambat

portal.test {
	php_server {
		root /app/public

		worker index.php {
			match /ekspor/*
			num 1
			max_threads 8
		}

		worker index.php {
			match *
			num 4
			max_threads 32
		}
	}
}

Dokumentasinya sendiri menambahkan catatan yang layak diulang: endpoint yang sangat lambat sebaiknya dijadikan asinkron lewat antrean, bukan sekadar dikurung di kolam terpisah. Pemisahan kolam adalah pertahanan, bukan perbaikan.

Observability

{
	servers {
		metrics
	}
}

Daftar periksa produksi

1. Image berbasis Debian (glibc), bukan Alpine.
2. num_threads dan max_threads ditentukan dari uji beban, bukan default.
3. GOMEMLIMIT disetel sesuai batas kontainer.
4. OPcache aktif dengan validate_timestamps=0.
5. try_files dan root eksplisit; aset statis dipisahkan.
6. Log JSON ke stdout, level yang tepat — bukan debug.
7. API admin (port 2019) tidak terjangkau dari luar.
8. Health check yang tidak menyentuh database.