FrankenPHP untuk Laravel

Menjalankan Laravel di FrankenPHP bisa sesederhana memasang folder proyek ke dalam kontainer. Yang perlu diputuskan adalah apakah kamu berhenti di situ, atau melanjutkan ke worker mode lewat Octane.

Cara 1 — Docker, tanpa konfigurasi

docker run -p 80:80 -p 443:443 -p 443:443/udp -v $PWD:/app dunglas/frankenphp

Dijalankan dari folder proyek Laravel, ini sudah cukup. Image resminya sudah tahu bahwa aplikasi PHP tinggal di /app dengan web root di public/.

Cara 2 — biner lokal

{
	frankenphp
}

localhost {
	root public/
	encode zstd br gzip

	php_server {
		try_files {path} index.php
	}
}

frankenphp run

Cara 3 — worker mode lewat Octane

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

Caddyfile sendiri untuk worker mode

{
	frankenphp {
		num_threads 16
		max_threads 48

		worker {
			file /app/public/frankenphp-worker.php
			num 8
			env APP_ENV production
			max_consecutive_failures 10
		}
	}
	# API admin hanya dari dalam kontainer
	admin localhost:2019
}

:8000 {
	root /app/public
	encode zstd br gzip

	# Aset statis dilayani langsung, tidak menyentuh PHP sama sekali
	@statis path /build/* /favicon.ico /robots.txt
	file_server @statis

	php_server {
		try_files {path} index.php
	}
}

Kumpulan utas terpisah untuk endpoint lambat

portal.test {
	php_server {
		root /app/public

		worker index.php {
			match /ekspor/*        # endpoint lambat punya kolamnya sendiri
			num 1
			max_threads 8
		}

		worker index.php {
			match *                # sisanya tidak terpengaruh
			num 4
			max_threads 32
		}
	}
}

Ini fitur yang tidak punya padanan langsung di tempat lain. Kalau ada satu endpoint yang memanggil layanan luar lambat, tanpa pemisahan ini ia bisa menghabiskan seluruh utas dan membuat halaman lain ikut mati. Dengan kolam terpisah, dampaknya terkurung — mirip bulkhead pada kapal.

Laravel sebagai satu biner

# static-build.Dockerfile
FROM --platform=linux/amd64 dunglas/frankenphp:static-builder-gnu

WORKDIR /go/src/app/dist/app
COPY . .
RUN rm -Rf tests/
RUN cp .env.example .env
RUN sed -i'' -e 's/^APP_ENV=.*/APP_ENV=production/' -e 's/^APP_DEBUG=.*/APP_DEBUG=false/' .env
RUN composer install --ignore-platform-reqs --no-dev -a

WORKDIR /go/src/app/
RUN EMBED=dist/app/ ./build-static.sh

frankenphp php-cli artisan optimize
frankenphp php-cli artisan migrate
frankenphp php-server

Yang perlu diperiksa setelah pindah

1. $request->ip() dan skema HTTPS benar — trusted proxy sudah diatur (Fase 1).
2. Unggahan besar tidak ditolak — periksa upload_max_filesize dan batas ukuran badan permintaan.
3. Semua ekstensi PHP yang kamu pakai aman terhadap utas.
4. Log keluar ke stdout/stderr, bukan ke berkas di dalam kontainer.
5. Endpoint health check merespons tanpa menyentuh database.