feat: SentTaskHandle and ReceivedTaskHandle - #2636

Open

nicolas-grekas wants to merge 48 commits into

nicolas-grekas:bgworker-tasks

Commits on Sep 30, 2026

fix: a thread that ended on its own can still be asked to shut down
nicolas-grekas
committed
531a5ab
feat: declared background workers + frankenphp_get_worker_handle()
nicolas-grekas
committed
2c34750
fix: a blocking receive on the handle marks a background worker ready
nicolas-grekas
committed
d66b65e
fix: never inherit the reserved worker variables
nicolas-grekas
committed
407bba8
fix: cap the restart backoff, and EOF a handle a forked child still holds
nicolas-grekas
committed
77fe5a5
fix: resolve max_threads auto on the HTTP budget
nicolas-grekas
committed
0a341c0
chore: simplifications and wording from the review
nicolas-grekas
committed
32645d0
test: cover the parked run and the handle cache
nicolas-grekas
committed
ba0249b
docs: flag frankenphp_get_worker_handle() experimental in the stub
nicolas-grekas
committed
502c060
feat: frankenphp_worker_tick(), the explicit ready point of background workers
nicolas-grekas
committed
f94625d
feat: FRANKENPHP_WORKER_BACKGROUND holds the name, HTTP workers untouched
nicolas-grekas
committed
cf0cc7d
feat: wake a background worker once at start
nicolas-grekas
committed
5c894d1
docs: event loop example for background workers
nicolas-grekas
committed
376818e
refactor: one lifecycle abstraction instead of two
nicolas-grekas
committed
5ea2489
fix: never block or race on the startup failure channel
nicolas-grekas
committed
4c83649
feat: max_execution_time bounds the bootstrap of a background worker
nicolas-grekas
committed
769cc4d
docs: stop the whole loop on drain in the Revolt example
nicolas-grekas
committed
2b706d0
test: only assert the bounded bootstrap where the timers are known to fire
nicolas-grekas
committed
ce8d5d5
feat: num defaults to one thread for background workers
nicolas-grekas
committed
bf63e1a
chore: review polish
nicolas-grekas
committed
d5c485f
test: the tick leaves the handle quiet
nicolas-grekas
committed
cf5ff26
fix: keep generating unique names for workers that share a script
nicolas-grekas
committed
9659857
feat: report the server of a worker as its own metric label
nicolas-grekas
committed
cdf6760
fix: address the review of the background worker lifecycle

alexandre-daubois
authored and
nicolas-grekas
committed
15f9587
fix: keep the declared path as the default worker name
nicolas-grekas
committed
b21e9fa
fix: pace only the background runs that end too fast
nicolas-grekas
committed
e412a28
refactor: declare the labels of a worker instead of widening the metrics
nicolas-grekas
committed
85ed2af
feat: report the server of a worker through an optional ServerMetrics interface

alexandre-daubois
authored and
nicolas-grekas
committed
9c3777a
feat: the handle of a background worker becomes an object
nicolas-grekas
committed
1516c46
refactor: keep the stream of a handle on the handle, not on the thread
nicolas-grekas
committed
4b4c510
docs: lead with the poll loop, the stream is for the libraries that take one
nicolas-grekas
committed
437e9da
fix: a handle built behind the constructor must not reach the Go side
nicolas-grekas
committed
fe7cb3d
fix: pace a crash loop whatever the run lasted
nicolas-grekas
committed
8e135b6
chore: check the server the same way in SendRequest and SendMessage
nicolas-grekas
committed
c7b4575
fix: form the Windows socket pair on loopback, and only with ourselves
nicolas-grekas
committed
77c7e69
feat: bound the wait for a background worker to become ready
nicolas-grekas
committed
6cfb168
chore: fewer comments, the ones left say why
nicolas-grekas
committed
3e77906
fix: Validate() refuses a worker scoped to a server it was not given
nicolas-grekas
committed
47cf687
chore: refresh the stub hash of the arginfo
nicolas-grekas
committed
ff61aba
feat: frankenphp_get_vars() and WorkerHandle::setVars()
nicolas-grekas
committed
e038ac9
fix: setVars() checks the thread like the rest of the handle
nicolas-grekas
committed
139ec91
feat: SentTaskHandle and ReceivedTaskHandle
nicolas-grekas
committed
78b134a
perf: build the stream of a task only when a script asks for one
nicolas-grekas
committed
d0e77a3
perf: wake a task through a kqueue user event on macOS
nicolas-grekas
committed
03c36e5
docs: wait on tasks through a context too, the stream second
nicolas-grekas
committed
85b1f36
test: let the busy-worker fixture see its task complete
nicolas-grekas
committed
550f752
fix: receive() checks the thread like the rest of the handle
nicolas-grekas
committed
b57af38
chore: fewer comments, the ones left say why
nicolas-grekas
committed
9ad72ef