valkyrjaio / valkyrja / 24230398784

100%

master: 100%

push

github

[Application] Add persistent worker HTTP support (#721)

# Description

Add persistent worker HTTP support

Introduces first-class support for long-running PHP worker runtimes
(FrankenPHP, OpenSwoole, RoadRunner) through a parent/child isolation
pattern that prevents request-scoped state from bleeding
  between requests.

What changed

New: WorkerHttp abstract entry class
(Application/Entry/Abstract/WorkerHttp)

The base class for all worker runtime integrations. Provides two static
methods:
- bootstrap(HttpConfig) — runs the full application bootstrap once at
process start, then calls bootstrapParentServices() to force-resolve any
services that should live in the frozen parent. Returns
the parent application, which must not be written to again.
- handle(ApplicationContract, ContainerData, ServerRequestContract) —
creates an isolated child container and child application per request,
dispatches through the standard seven-stage HTTP
  pipeline, then discards the child. The parent is never mutated.

Concrete runtime integrations extend this class and supply the request
loop. They are shipped as separate packages (valkyrja/frankenphp,
valkyrja/openswoole, valkyrja/roadrunner).

New: ChildContainer — the default per-request container. Delegates to
the parent via ContainerContract (portable, works with any
implementation). Takes a ContainerData snapshot on construction; PHP
copy-on-write means each child gets its own logical copy of the parent's
maps at zero cost until it writes.

New: NativeChildContainer — a PHP-specific alternative that accesses the
parent's protected fields directly instead of calling methods,
eliminating any risk of accidentally triggering deferred
publishing or writing to parent state. Requires a concrete Container
parent. Use only when profiling confirms a bottleneck at high child
construction rates.

Both containers share the same invariant: neither triggers deferred
resolution in the parent. A child reuses a parent singleton only ... (continued)

177 of 177 new or added lines in 9 files covered. (100.0%)

13032 of 13032 relevant lines covered (100.0%)

16.52 hits per line