kinetis / roadrunner-adapter

v1.2.1 2026-09-13 11:01 UTC

Requires

• php: ^8.4
• kinetis/framework: ^1.8.1
• nyholm/psr7: ^1.8.2
• psr/http-message: ^2.0
• spiral/roadrunner-http: ^4.1
• spiral/roadrunner-worker: ^3.5

Requires (Dev)

• infection/infection: ^0.35.0
• phpstan/phpstan: ^2.2.8
• phpunit/phpunit: ^13.3.3
• spiral/roadrunner-cli: ^2.6
• vimeo/psalm: ^6.17

MIT

• Alon Noy

Published on Packagist.org on 2026-09-13 11:14 UTC

README

kinetis/roadrunner-adapter
RoadRunner runtime adapter for Kinetis

Part of Kinetis, a non-blocking PHP framework for API-first applications, developed in the kinetis-dev/kinetis monorepo.

Speaks RoadRunner's own Goridge/PSR7Worker protocol — a persistent worker loop, structurally the closest of Kinetis's four runtime adapters to FrankenPhpAdapter's, but built on RoadRunner's own PHP worker library rather than a raw request-handling function. Converts to and from PSR-7 and hands the request body on as raw bytes, which core's own RequestBodyMiddleware then stages, bounds and parses.

There's nothing to configure or call directly: install the package, and RuntimeDetector picks it up automatically the moment RR_MODE=http is set in the environment — RoadRunner's own rr serve sets this itself when it spawns the worker.

composer require kinetis/roadrunner-adapter

Two RoadRunner configuration settings are required, not optional — http.raw_body: true, and http.max_request_size to bound a body whose length was never declared, which nothing at the PHP layer can (there's no SAPI here to enforce post_max_size, and RoadRunner's own default is a generous 1000 MB):

http:
  address: 0.0.0.0:8080
  raw_body: true
  max_request_size: 10

A missing raw_body: true doesn't fail silently: this adapter reads the flag RoadRunner stamps on every request and refuses one RoadRunner already parsed. It refuses a request that doesn't carry that flag at all, too — that means the setting can't be verified, not that it's on.

max_request_size is a separate ceiling from MAX_BODY_SIZE (Kinetis's own env var, default 2 MiB) — the two don't automatically agree; set MAX_BODY_SIZE=10485760 alongside max_request_size: 10 above if you want one consistent limit. Both sit alongside Kinetis\Http\Form\FormLimits, which bounds how complicated a form may be (input variables counted from the raw body, file parts, nesting depth, multipart parts including unnamed ones, and header lines per part), and alongside Kinetis\Http\Form\MultipartEnvelope, which settles what a multipart body may say on the wire — delimiters, transfer encodings, metadata and nesting. Both are core's, applied by core's own middleware, so a form means the same thing here as it does under FrankenPHP.

X-Forwarded-Proto is read only from a peer listed in TRUSTED_PROXIES. A directly reachable rr serve with no policy configured reads it from nobody, which is the safe default for that deployment — the header is an ordinary one any client can send.

Requires PHP 8.4+ and kinetis/framework. See Runtime Adapters for the full reasoning — why raw_body: true and max_request_size matter, what's mapped and how, and the two environment-caused limitations (a purely-numeric header name; cookie order) that are upstream RoadRunner behavior rather than something this package's own code can recover from. Both are declared to the shared runtime conformance suite and asserted there in both directions, not skipped.

License

MIT — see LICENSE.