feat: SentTaskHandle and ReceivedTaskHandle - #2636

Open

nicolas-grekas wants to merge 46 commits into

nicolas-grekas:bgworker-tasks

Commits on Sep 21, 2026

fix: a thread that ended on its own can still be asked to shut down
nicolas-grekas
committed
b6a2a5a
feat: declared background workers + frankenphp_get_worker_handle()
nicolas-grekas
committed
bf157b2
fix: a blocking receive on the handle marks a background worker ready
nicolas-grekas
committed
c1bb3d4
fix: never inherit the reserved worker variables
nicolas-grekas
committed
fa8f2f3
fix: cap the restart backoff, and EOF a handle a forked child still holds
nicolas-grekas
committed
a20f100
fix: resolve max_threads auto on the HTTP budget
nicolas-grekas
committed
a6642b5
chore: simplifications and wording from the review
nicolas-grekas
committed
a335efd
test: cover the parked run and the handle cache
nicolas-grekas
committed
c6c8c19
docs: flag frankenphp_get_worker_handle() experimental in the stub
nicolas-grekas
committed
e87ed07
feat: frankenphp_worker_tick(), the explicit ready point of background workers
nicolas-grekas
committed
728c2e7
feat: FRANKENPHP_WORKER_BACKGROUND holds the name, HTTP workers untouched
nicolas-grekas
committed
455805a
feat: wake a background worker once at start
nicolas-grekas
committed
e7708f7
docs: event loop example for background workers
nicolas-grekas
committed
af6af2b
refactor: one lifecycle abstraction instead of two
nicolas-grekas
committed
1025c18
fix: never block or race on the startup failure channel
nicolas-grekas
committed
bcd2575
feat: max_execution_time bounds the bootstrap of a background worker
nicolas-grekas
committed
54258b5
docs: stop the whole loop on drain in the Revolt example
nicolas-grekas
committed
7d444b4
test: only assert the bounded bootstrap where the timers are known to fire
nicolas-grekas
committed
c751f32
feat: num defaults to one thread for background workers
nicolas-grekas
committed
6d98cf4
chore: review polish
nicolas-grekas
committed
b356adc
test: the tick leaves the handle quiet
nicolas-grekas
committed
6aae1f4
fix: keep generating unique names for workers that share a script
nicolas-grekas
committed
080f811
feat: report the server of a worker as its own metric label
nicolas-grekas
committed
e6bb048
fix: address the review of the background worker lifecycle

alexandre-daubois
authored and
nicolas-grekas
committed
bac97ae
fix: keep the declared path as the default worker name
nicolas-grekas
committed
5c4be27
fix: pace only the background runs that end too fast
nicolas-grekas
committed
8bc93f9
refactor: declare the labels of a worker instead of widening the metrics
nicolas-grekas
committed
b03f915
feat: report the server of a worker through an optional ServerMetrics interface

alexandre-daubois
authored and
nicolas-grekas
committed
d56d1bc
feat: the handle of a background worker becomes an object
nicolas-grekas
committed
37f4020
refactor: keep the stream of a handle on the handle, not on the thread
nicolas-grekas
committed
7973741
docs: lead with the poll loop, the stream is for the libraries that take one
nicolas-grekas
committed
15bec04
fix: a handle built behind the constructor must not reach the Go side
nicolas-grekas
committed
22f6864
fix: pace a crash loop whatever the run lasted
nicolas-grekas
committed
ea9a619
chore: check the server the same way in SendRequest and SendMessage
nicolas-grekas
committed
06442ab
fix: form the Windows socket pair on loopback, and only with ourselves
nicolas-grekas
committed
e4bf656
feat: bound the wait for a background worker to become ready
nicolas-grekas
committed
786b82a
chore: fewer comments, the ones left say why
nicolas-grekas
committed
5b603d9
feat: frankenphp_get_vars() and WorkerHandle::setVars()
nicolas-grekas
committed
2e985ad
fix: setVars() checks the thread like the rest of the handle
nicolas-grekas
committed
d374bef
feat: SentTaskHandle and ReceivedTaskHandle
nicolas-grekas
committed
8347a7b
perf: build the stream of a task only when a script asks for one
nicolas-grekas
committed
5eff671
perf: wake a task through a kqueue user event on macOS
nicolas-grekas
committed
becaa36
docs: wait on tasks through a context too, the stream second
nicolas-grekas
committed
a56caad
test: let the busy-worker fixture see its task complete
nicolas-grekas
committed
b80ce89
fix: receive() checks the thread like the rest of the handle
nicolas-grekas
committed
6b0c639
chore: fewer comments, the ones left say why
nicolas-grekas
committed
8925005